Aether documentation

Aether is an agent-native financial search engine, published as a remote MCP server. Every result is a citation-complete payload — exact source text, an accession-numbered citation and a link back to the primary document — so an agent can use it as evidence without fetching or parsing a web page.

Endpoint

MCP (Streamable HTTP): https://aether.evidinvest.com/mcp

Search API origin: https://api.aether.evidinvest.com

Auth: OAuth 2.1 (authorization code + PKCE, or device code)

The transport is MCP Streamable HTTP, stateless: each POST is a self-contained JSON-RPC exchange. Step-by-step client setup for ChatGPT, Claude, Cursor and the CLI lives on /connect.

Authentication

Aether is an OAuth 2.1 authorization server and a protected resource. Clients discover everything they need from the two standard metadata documents — no configuration is hard-coded:

GET https://aether.evidinvest.com/.well-known/oauth-authorization-server
GET https://api.aether.evidinvest.com/.well-known/oauth-protected-resource

Register. Clients that do not have a client_id register themselves at /v1/oauth/register (RFC 7591 dynamic client registration). Public clients only — no client secret is issued, because PKCE is what protects the code.
Authorize. The user is sent to /v1/oauth/authorize, signs in (email + password, or Google / Microsoft SSO, with optional TOTP MFA), and approves the requested scopes on a consent screen. Headless clients can instead use the RFC 8628 device-code flow at /v1/oauth/device/code.
Exchange. The authorization code plus the PKCE verifier (S256 only) is exchanged at /v1/oauth/token for an access token and a rotating refresh token. Tokens are opaque and stored only as hashes.
Call. Send the access token as Authorization: Bearer …. Revoke at any time via /v1/oauth/revoke or from your dashboard.

Scopes: aether.search, aether.search.partners, aether.partners.proxy, aether.seller.read, aether.account.read. Tokens are granted the intersection of what you request and what the client is allowed.

Tools

The server exposes 14 tools. Read and write tools are separate — there is no catch-all request tool — and every tool carries a title and MCP annotation hints. “Account” means a signed-in Aether account (OAuth); “Seller key” means a marketplace seller API key passed as an argument.

Tool	Access	Auth
search Search all Aether corpora One query across every corpus at once — SEC filings, Japan/EDINET and Korea/DART annual reports, EU financial regulation, and earnings calls — auto-routed and merged into one corpus-tagged, citation-complete result set. Start here for most questions.	Read-only	Account
financial_search Search SEC filings Forces the filings corpus: 10-K, 10-Q, 8-K, registration statements and press exhibits, with hybrid semantic + keyword retrieval and cross-encoder reranking. Each hit carries the exact section text, form type, filing date, accession-numbered citation and source URL.	Read-only	Account
transcript_search Search earnings-call transcripts Verbatim speaker turns from earnings calls and earnings press-release exhibits — prepared remarks and analyst Q&A — with speaker name and role, fiscal period, call date and source URL. Filterable by ticker, speaker role and lookback window.	Read-only	Account
regulation_search Search EU financial regulation Article-level retrieval over a 29-act EU corpus (MiFID II, MiFIR, MAR, MiCA, DORA, CRR/CRD, UCITS, AIFMD, PSD2, Solvency II, SFDR, CSRD, the 2024 AML package and more). Returns citable Article-paragraphs, recitals and annex blocks with a human breadcrumb.	Read-only	Account
holdings_by_security Institutional holders of a stock (13F) Who owns a stock: institutional holders from SEC Form 13F ranked by position value, with quarter-over-quarter share changes, each row citing its accession number and EDGAR URL. US-listed long equity and options only, filed 45 days after quarter end.	Read-only	Account
holdings_by_manager A fund's reported equity book (13F) What a fund owns: a manager's reported positions from Form 13F with new/increased/decreased flags, plus the filer's published signatory, phone and business address from the filing cover page. Look up by manager name or exact CIK.	Read-only	Account
list_partners List data partners Catalog discovery for the Aether marketplace: which third-party data sellers are active, which modes they offer (indexed or proxy) and the per-call credit cost of each. Read-only; returns no search results and incurs no charge.	Read-only	Anonymous
partner_search Search a data partner Search documents published into the marketplace by registered sellers (research notes, supply-chain analyses). Returns ranked chunks with explicit per-document attribution and licence terms; scope with the partner slugs from list_partners.	Read-only	Account
partner_proxy_search Search across data partners Routes a query server-to-server to seller-registered API endpoints. Consumes prepaid credits at the per-call rate shown by list_partners, requires partners to be named explicitly and requires confirm_charge — no fan-out and no surprise charges.	Read-only	Account + credits
seller_list_my_documents List my published documents For marketplace sellers: lists the documents you have published, with indexing status (pending / indexed / failed / revoked) and chunk count.	Read-only	Seller key
seller_list_my_endpoints List my registered endpoints For marketplace sellers: lists the proxy endpoints you have registered. Secrets are never returned — only a boolean saying whether one is configured.	Read-only	Seller key
seller_signup Register as a data seller Creates a marketplace seller account and returns an API key once. New accounts start as pending_review and are not surfaced in search until approved.	Write	Anonymous (rate-limited)
seller_publish_document Publish a seller document Publishes or replaces a document in the marketplace. Content is chunked, embedded and indexed by a background worker; re-publishing the same external_doc_id supersedes the prior version.	Write	Seller key
seller_register_endpoint Register a seller endpoint Registers a proxy endpoint. Aether stores the auth secret encrypted at rest (AES-256-GCM) and routes queries server-to-server, so calling agents never see the URL or token.	Write	Seller key

The live catalog, including input schemas, is always available from tools/list over MCP or GET https://api.aether.evidinvest.com/v1/tools.

Coverage and provenance

SEC filings — 10-K, 10-Q, 8-K, registration statements and exhibits, S&P 500 coverage across roughly ten years, plus non-US registries (Sweden/Bolagsverket, Japan/EDINET, Korea/DART).
Earnings calls — call transcripts and earnings press-release exhibits, segmented by speaker turn.
EU regulation — 29 acts, roughly 13,000 citable units, with consolidated-text preference available.
Form 13F holdings — four quarters, all filing managers.

Numbers are returned as filed and are never adjusted or restated by us. Aether is an information-retrieval tool. It does not execute trades or move money, and nothing it returns is investment, legal or tax advice — see the terms.

Pricing and credits

Registering is free. Verify your email and you get a three-month trial of up to 5,000 calls per hour with no card; after the trial an account keeps a free tier of 200 calls per hour. Beyond that, calls draw on prepaid credits bought in packs through Stripe:

Pack	Price	Effective rate
1,000 credits	$5	$0.0050 / call
2,200 credits	$10	$0.0045 / call
6,000 credits	$25	$0.0042 / call
30,000 credits	$100	$0.0033 / call

Credits are decremented atomically and refunded automatically if a call fails. Marketplace proxy calls (partner_proxy_search) cost the seller’s published per-call rate and require an explicit confirmation flag. Balance and history live on your billing page.

Rate limits and errors

Unverified accounts: 5 calls/hour. Verified free tier: 200 calls/hour. Trial: 5,000 calls/hour.
Dynamic client registration is capped per source IP per hour; sign-in, token and reset endpoints are individually throttled.
Errors are typed, not generic: 401 when the token is missing or invalid, 402 when credits run out — carrying a top-up link rather than a bare failure — and 429 when a rate limit is hit.

Support and policies

Aether is operated by EBD Sweden AB (EvidInvest), Sweden. Email aether@evidinvest.com — see /support for what to include and response times, /privacy for the privacy policy, and /terms for the terms of service.