aether-developer

Everything you need to call Aether — the financial-vertical agent search engine — from your own code or your favourite MCP-enabled IDE.

The repo holds two kinds of integration plus the docs that explain them:

1. MCP wrapper — @evidinvest/aether-mcp. Drop it into Claude Desktop, Cursor, Cline, or any stdio-MCP client and you can search SEC filings, earnings transcripts, and EU financial regulation (MiFID II, MiCA, CRR, GDPR, …) from chat.
2. Client libraries — small typed HTTP clients in TypeScript / Python (and more languages over time). For when you're building your own service instead of using an MCP-aware UI.

aether-developer/
├── docs/                    — how to use Aether for search / via MCP
├── mcp/                     — @evidinvest/aether-mcp (stdio MCP server)
├── clients/
│   ├── typescript/          — @evidinvest/aether-sdk
│   └── python/              — aether-sdk (PyPI)
└── examples/                — runnable demos + config snippets

Quick start

Claude Desktop / Cursor / Cline (MCP)

Add this to your client's MCP-server config:

{
  "mcpServers": {
    "aether": {
      "command": "npx",
      "args": ["-y", "@evidinvest/aether-mcp"]
    }
  }
}

First run prints a device-code URL — open it, sign in, approve. Full guide: docs/mcp.md.

TypeScript / Node

pnpm add @evidinvest/aether-sdk

import { AetherClient } from "@evidinvest/aether-sdk";

const aether = new AetherClient({ apiKey: process.env.AETHER_API_KEY });
const { hits } = await aether.search({ query: "Apple supply-chain risk", limit: 5 });

Full guide: clients/typescript/README.md.

Python

pip install aether-sdk

from aether import AetherClient

with AetherClient(api_key="ak_...") as aether:
    result = aether.search(query="Apple supply-chain risk", limit=5)
    for hit in result.hits:
        print(hit.score, hit.section_title)

Full guide: clients/python/README.md.

Docs

• docs/search.md — request/response shapes, auth, schemas.
• docs/regulation_search.md — EU financial-regulation search (MiFID II, MiCA, CRR, GDPR, … — 29 acts), filters, response shape, curl.
• docs/mcp.md — MCP setup for Claude Desktop, Cursor, Cline, env overrides.

Get an API key

https://aether.evidinvest.com/developer/keys

3 months free. Verify your email when you sign up and you're on the trial tier automatically — up to 5,000 API calls/hour on Aether's search tools, free for 3 months. No card required; it reverts to the free tier (100 calls/hour + paid credits) when the trial ends.

Contribute a client library

The TypeScript and Python clients are intentionally tiny — one bearer-token fetch wrapper + typed shapes for /v1/search. Porting to Go, Rust, Java, etc. should fit in ~150 lines. Open a PR under clients/<lang>/.

License

Apache-2.0 — see LICENSE.