{
  "markdown": "# aether-developer\n\nEverything you need to connect [Aether](https://aether.evidinvest.com) — the\nsearch engine built for agents, over SEC filings, earnings-call transcripts,\nand EU financial regulation — to your LLM, your IDE, or your own code.\n\nEvery result is a ready-to-cite evidence payload: the exact filed passage,\nan accession-numbered citation, the sec.gov / EUR-Lex link, and a confidence\nscore. No filing, no answer — your agent stops inventing numbers.\n\n```\naether-developer/\n├── docs/                — connection guides + REST API reference\n│   ├── chatgpt.md       — ChatGPT Developer Mode setup\n│   ├── mcp.md           — Claude / Cursor / Cline / any MCP client\n│   ├── cursor.md        — Cursor specifics (one-click install)\n│   └── search.md        — REST API reference (/v1/tools/*)\n├── skills/              — Agent Skills (drop into ~/.claude/skills)\n├── mcp/                 — @evidinvest/aether-mcp (stdio MCP server, npm)\n├── clients/\n│   ├── typescript/      — @evidinvest/aether-sdk (npm)\n│   └── python/          — evidinvest-aether-sdk (PyPI)\n└── examples/            — runnable demos + config snippets\n```\n\n## Connect your LLM (no code)\n\n**MCP endpoint:** `https://api.aether.evidinvest.com/mcp` · Auth: OAuth\n(sign in when your client prompts — free account).\n\n| Client | How | Guide |\n|---|---|---|\n| **ChatGPT** | Settings → Apps & Connectors → Developer mode → Create connector with the URL above | [`docs/chatgpt.md`](./docs/chatgpt.md) |\n| **Claude (web/Desktop)** | Settings → Connectors → Add custom connector with the URL above | [`docs/mcp.md`](./docs/mcp.md) |\n| **Claude Code** | `claude mcp add --transport http aether https://api.aether.evidinvest.com/mcp` | [`docs/mcp.md`](./docs/mcp.md) |\n| **Cursor** | [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=Aether&config=eyJ1cmwiOiJodHRwczovL2FldGhlci5ldmlkaW52ZXN0LmNvbS9tY3AifQ==) | [`docs/cursor.md`](./docs/cursor.md) |\n| **Cline / Continue / other stdio MCP** | `npx -y @evidinvest/aether-mcp` in the client's MCP config | [`docs/mcp.md`](./docs/mcp.md) |\n\nThen ask: *\"What does Apple's latest 10-K say about supply-chain risk?\nQuote the passage with the sec.gov link.\"*\n\n## Teach your agent the craft (skills)\n\nMCP gives the agent the tools; the [`skills/`](./skills/) directory teaches\nit the craft — tool routing, citation discipline, point-in-time transcript\nretrieval:\n\n```bash\ncp -r skills/aether-research ~/.claude/skills/   # Claude Code, personal\n```\n\nSee [`skills/README.md`](./skills/README.md) for Claude Desktop / other\nframeworks.\n\n## Call the API from code\n\nThree REST endpoints — the same tools MCP exposes\n([full reference](./docs/search.md)):\n\n```\nPOST /v1/tools/financial_search    POST /v1/tools/transcript_search    POST /v1/tools/regulation_search\n```\n\n### TypeScript / Node\n\n```bash\npnpm add @evidinvest/aether-sdk\n```\n\n```ts\nimport { AetherClient } from \"@evidinvest/aether-sdk\";\n\nconst aether = new AetherClient({ apiKey: process.env.AETHER_API_KEY });\nconst out = await aether.financialSearch({ query: \"Apple supply-chain risk\", limit: 5 });\nfor (const c of out.results) console.log(c.citation, c.metadata?.source_url);\n```\n\n### Python\n\n```bash\npip install evidinvest-aether-sdk\n```\n\n```python\nfrom aether import AetherClient\n\nwith AetherClient(api_key=\"ak_...\") as aether:\n    out = aether.financial_search(query=\"Apple supply-chain risk\", limit=5)\n    for c in out.results:\n        print(c.citation, c.metadata.get(\"source_url\"))\n```\n\n### curl / any language\n\n```bash\ncurl -sS https://api.aether.evidinvest.com/v1/tools/financial_search \\\n  -H \"authorization: Bearer $AETHER_API_KEY\" \\\n  -H \"content-type: application/json\" \\\n  -d '{\"query\":\"supply chain risk Taiwan\",\"limit\":5}' | jq .\n```\n\n## Docs\n\n- [`docs/search.md`](./docs/search.md) — REST API reference: all three tools, params, response shape.\n- [`docs/regulation_search.md`](./docs/regulation_search.md) — EU financial-regulation search deep-dive (29 acts), filters, curl.\n- [`docs/mcp.md`](./docs/mcp.md) — connect any MCP client (remote URL or stdio), env overrides.\n- [`docs/chatgpt.md`](./docs/chatgpt.md) — ChatGPT Developer Mode walkthrough.\n- [`docs/cursor.md`](./docs/cursor.md) — Cursor one-click install.\n\n## Get an API key\n\nhttps://aether.evidinvest.com/developer/keys — anonymous calls work but are\nrate-limited; keys are free.\n\n## What's in the corpus\n\n- **SEC filings** — 10-K / 10-Q / 8-K, registration statements,\n  prospectuses, press exhibits; ~10 years of S&P 500 and beyond.\n- **Non-US registries** — Sweden (Bolagsverket), Japan (EDINET),\n  Korea (DART) annual reports; scope with `jurisdiction: [\"SE\"|\"JP\"|\"KR\"]`.\n- **Earnings calls** — speaker-attributed transcripts + furnished press\n  exhibits, with point-in-time filters (`order: \"earliest\"` finds first\n  mentions).\n- **EU regulation** — MiFID II, MiCA, DORA, the AML package; article-level\n  citations.\n\n**3 months free.** Verify your email when you sign up and you're on the trial\ntier automatically — up to 5,000 API calls/hour on Aether's search tools, free\nfor 3 months. No card required; it reverts to the free tier (100 calls/hour +\npaid credits) when the trial ends.\n\n## Contribute a client library\n\nThe TypeScript and Python clients are intentionally tiny — one bearer-token\nfetch wrapper + typed shapes for the three `/v1/tools/*` endpoints. Porting\nto Go, Rust, Java, etc. is ~150 lines. Open a PR under `clients/<lang>/`.\n\n## License\n\nApache-2.0 — see [LICENSE](./LICENSE).\n",
  "bytes": 5518,
  "sha": "30c948c9b77a536232acae58f20efcd79c62a4299d6f87bb40bed3a67deb6417",
  "repo_slug": "evidinvest/aether-developer",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_evidinvest_aether_developer_f7547a1c/readme"
}