Quick index
- - Public report search API: GET https://veda.ng/api/reports/search?q=agents&corpus=ai (OpenAlex-backed; see https://veda.ng/openapi.json)
- - OpenAPI 3.1 specification: https://veda.ng/openapi.json
- - MCP server over Streamable HTTP (JSON-RPC 2.0): https://veda.ng/.well-known/mcp; tools: search_essays, get_essay, search_glossary, get_glossary_term, search_reports
- - RSS feed: https://veda.ng/feed.xml
- - Sitemap: https://veda.ng/sitemap.xml
- - Agent manifests: https://veda.ng/.well-known/agents.json, https://veda.ng/ai.json, https://veda.ng/ai.txt
- - Markdown access: send Accept: text/markdown on any page URL
- - No authentication required for any read endpoint. Contact: vatsvedang@gmail.com
Report search API
Search 233,000+ indexed academic papers across the AI and Web3 corpora, backed by OpenAlex and sorted by citations. Results are cached for one hour.
GET /api/reports/search?q=stablecoin+regulation&corpus=ai&page=1&per_page=20
Parameters: q (required, min 2 chars), corpus (ai or web3), page, per_page (max 200). The full contract lives in the OpenAPI 3.1 spec.
MCP server (Model Context Protocol)
A first-party MCP server runs at /.well-known/mcp using the Streamable HTTP transport with JSON-RPC 2.0. It is stateless, needs no auth, and supports protocol versions 2025-06-18, 2025-03-26, and 2024-11-05.
Exposed tools:
search_essays- find essays by keywordget_essay- full Markdown text of one essaysearch_glossary- search 100+ term glossaryget_glossary_term- full definition of one termsearch_reports- cited academic literature via OpenAlex
curl -X POST https://veda.ng/.well-known/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"my-client","version":"1.0"}}}'Markdown content negotiation
Every essay, every glossary term, and key pages serve Markdown to machines. Send an Accept header instead of parsing HTML:
curl -H "Accept: text/markdown" https://veda.ng/agentstack
Feeds & discovery files
- feed.xml - RSS feed of new essays
- sitemap.xml - every public URL
- llms.txt - structured index for LLMs (full-text version)
- agents.json - when-to-use guidance and capabilities
- ai.txt - training, indexing, and citation permissions (allowed)