API
Open both ways: your APIs in, KYP out
Wire your own data into KYP, and take findings, citations and checks back into your systems and AI agents, through the API and MCP.
Preview. Endpoint names and fields may change before release.
# Register your own API as a KYP connector (preview) curl -X POST $KYP_API_URL/api/connectors \ -H "Authorization: Bearer $KYP_API_KEY" \ -d '{ "name": "Group asset register", "base_url": "https://data.your-company.com/assets", "auth": { "type": "oauth2_client_credentials" }, "provides": ["asset_capacity", "commissioning_date", "offtake"], "check_against": ["capacity_claims", "cod_claims"] }' # From then on, each new data room is checked against it, # and findings cite it as a source, with the date it was read.
# A finding's citation: quote, page and source document curl $KYP_API_URL/api/findings/{finding_id}/citation \ -H "Authorization: Bearer $KYP_API_KEY" # Check a seller's capacity against the national registry curl -X POST $KYP_API_URL/api/cases/{case_id}/verify-registry \ -H "Authorization: Bearer $KYP_API_KEY" # Every project in the workspace curl $KYP_API_URL/api/projects \ -H "Authorization: Bearer $KYP_API_KEY"
{
"finding": {
"statement": "Grid connection agreement not yet executed",
"quote": "A grid connection agreement has not been executed...",
"page": 2,
"severity": "critical",
"review_state": "approved"
},
"source": { "title": "Helios_Energy_Yield_Assessment_MRA_RevB.pdf" },
"kind": "pdf",
"page": 2,
"pages": 6
}
// Add KYP to an MCP client (e.g. Claude Desktop) { "mcpServers": { "kyp": { "url": "$KYP_MCP_URL", "headers": { "Authorization": "Bearer $KYP_API_KEY" } } } }
# Planned tools list_projects Projects in your workspace, with stage and risk score get_findings Findings for a project, with severity and review state get_citation The quote, page and source document behind a finding verify_capacity Check a capacity claim against national registries get_requirements Document requirements for a country, technology and stage market_snapshot Dated market data for a country or bidding zone cost_of_energy Levelized cost of energy with a country tax pack
# Claude plugin for KYP (planned; names may change) /plugin install kyp-energy-dd # Commands, backed by your KYP workspace /kyp:first-read First read of a new data room: gaps, red flags, seller requests /kyp:market Market brief for the project's country and zone /kyp:ic-memo Draft the investment-committee memo from approved findings