{"openapi":"3.1.0","info":{"title":"EVM Copilot API","version":"0.1.0","description":"Competitive analysis and research engine for the EVM ecosystem. Search hackathon projects, launched protocols, dead/rugged projects, research archives, and VC investment theses."},"servers":[{"url":"https://mcp.luca3.com","description":"Production"}],"paths":{"/api/v1/search/projects":{"post":{"operationId":"searchProjects","summary":"Hybrid semantic search over EVM projects (hackathons, launched protocols, dead/rugged)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Natural language search query"},"filters":{"type":"object","properties":{"source":{"type":"array","items":{"type":"string"},"description":"Filter by source (ethglobal, devpost, defillama, rekt)"},"lifecycle":{"type":"array","items":{"type":"string","enum":["hackathon","launched","dead","rugged","acquired"]}},"chains":{"type":"array","items":{"type":"string"},"description":"EVM chains (ethereum, base, arbitrum, optimism, etc.)"},"category":{"type":"array","items":{"type":"string"},"description":"Category (DEX, Lending, Bridge, etc.)"}}},"limit":{"type":"number","description":"Max results (default 20, max 100)"},"offset":{"type":"number","description":"Pagination offset"}}}}}},"responses":{"200":{"description":"Search results with scores and channel stats"}}}},"/api/v1/search/archives":{"post":{"operationId":"searchArchives","summary":"Search curated EVM research archives with auto-cascade retrieval","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"filters":{"type":"object","properties":{"sourceType":{"type":"array","items":{"type":"string"},"description":"eip, ethresearch, ef-blog, conference, protocol-docs, security, investor-research, vitalik-blog"}}},"limit":{"type":"number"},"depth":{"type":"string","enum":["shallow","standard","deep"]}}}}}},"responses":{"200":{"description":"Archive search results with retrieval tier info"}}}},"/api/v1/search/vc-theses":{"post":{"operationId":"searchVCTheses","summary":"Semantic search over VC investment theses (a16z, Paradigm, Dragonfly, etc.)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"limit":{"type":"number"}}}}}},"responses":{"200":{"description":"Matching VC theses with firm info"}}}},"/api/v1/projects/{id}":{"get":{"operationId":"getProject","summary":"Get full project details by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Project details"}}}},"/api/v1/archives/{id}":{"get":{"operationId":"getArchiveDocument","summary":"Get archive document content (paginated)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"number","default":1}},{"name":"pageSize","in":"query","schema":{"type":"number","default":5000}}],"responses":{"200":{"description":"Document content with pagination"}}}},"/api/v1/vcs/{slug}":{"get":{"operationId":"getVCFirm","summary":"Get VC firm profile","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"VC firm details"}}}},"/api/v1/vcs/{slug}/portfolio":{"get":{"operationId":"getVCPortfolio","summary":"Get VC portfolio companies","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"chain","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Portfolio companies"}}}},"/api/v1/analyze":{"post":{"operationId":"analyzeCohort","summary":"Analyze tag/chain/category distributions within a project cohort","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"type":"object"},"dimensions":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Cohort analysis"}}}},"/api/v1/compare":{"post":{"operationId":"compareCohorts","summary":"Compare two project cohorts","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cohortA","cohortB"],"properties":{"cohortA":{"type":"object"},"cohortB":{"type":"object"},"dimensions":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Cohort comparison with lift/delta"}}}},"/api/v1/filters":{"get":{"operationId":"getFilters","summary":"Get canonical filter values and corpus statistics","responses":{"200":{"description":"Available filters and stats"}}}},"/api/v1/stats":{"get":{"operationId":"getStats","summary":"Get corpus statistics","responses":{"200":{"description":"Project/document/VC counts"}}}}}}