{"openapi":"3.1.0","info":{"title":"Corey James portfolio API","version":"1.0.0","description":"Evidence-cited answers about the work of Corey James, an AI systems architect and research engineer. Every figure returned is one on the page it cites. The same tools are served over MCP at /mcp and A2A at /a2a."},"servers":[{"url":"https://coreyjames.ai"}],"paths":{"/api/match_role":{"get":{"operationId":"match_role","summary":"Evidence-backed fit report for a job description or list of requirements: covered, partial and gap, each with page citations.","parameters":[{"name":"requirements","in":"query","required":true,"description":"The job description or requirement list, one per line","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON with a markdown field, or Markdown when format=md","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/search_portfolio":{"get":{"operationId":"search_portfolio","summary":"Search systems, stories, capabilities, technologies and patent applications; results carry measured figures and evidence lines.","parameters":[{"name":"query","in":"query","required":true,"description":"What to look for","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"system, story, capability, idea, technology, patent-family or tool-group","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum results, default 8","schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/get_page":{"get":{"operationId":"get_page","summary":"The full record for one page by URL.","parameters":[{"name":"url","in":"query","required":true,"description":"Page URL or path","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/search":{"get":{"operationId":"search","summary":"Connector-style search: id, title, url per result.","parameters":[{"name":"query","in":"query","required":true,"description":"What to look for","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/fetch":{"get":{"operationId":"fetch","summary":"Connector-style fetch: the page as Markdown with metadata.","parameters":[{"name":"id","in":"query","required":true,"description":"The page path from search","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/list_systems":{"get":{"operationId":"list_systems","summary":"The ten systems with their one-line results.","parameters":[{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/list_capabilities":{"get":{"operationId":"list_capabilities","summary":"The capabilities.","parameters":[{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/list_ideas":{"get":{"operationId":"list_ideas","summary":"The engineering principles.","parameters":[{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/list_technologies":{"get":{"operationId":"list_technologies","summary":"The technologies, optionally by kind.","parameters":[{"name":"kind","in":"query","required":false,"description":"Technology kind","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/list_patent_applications":{"get":{"operationId":"list_patent_applications","summary":"The five provisional patent applications with application numbers.","parameters":[{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/who":{"get":{"operationId":"who","summary":"Who Corey James is: positioning, identifiers (ORCID, GitHub, GitLab), contact, knowsAbout.","parameters":[{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/scale":{"get":{"operationId":"scale","summary":"The portfolio's scale figures.","parameters":[{"name":"format","in":"query","required":false,"description":"md for Markdown instead of JSON","schema":{"type":"string","enum":["md"]}}],"responses":{"200":{"description":"JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/contact":{"post":{"operationId":"contact","summary":"Send Corey James a message. The sender's own name and email are required.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","email","message"],"properties":{"name":{"type":"string"},"email":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"200":{"description":"Delivery result"}}}}}}