Enables AI agents to perform cited searches over SEC filings, earnings transcripts, and EU financial regulations with precise evidence payloads.
Also known as EvidInvest/aether-developer, @evidinvest/aether-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 203
- Latest version
- 0.3.4
- Last commit
- Sep 11, 2026
- License
- Apache-2.0
What is Aether MCP?
Aether enables AI agents to perform cited searches over SEC filings, earnings transcripts, and EU financial regulations with precise evidence payloads.
Summary generated from the project's README
About Aether MCP server
Aether-developer provides a specialized search interface for AI agents to access verified financial data. It connects large language models to a corpus containing SEC filings, earnings call transcripts, and EU financial regulations. By using this server, developers ensure their agents provide cited evidence rather than hallucinated numbers, as every result includes an accession-numbered citation, a direct link to sec.gov or EUR-Lex, and a confidence score.
Users can connect via a remote MCP endpoint using OAuth for clients like Claude, ChatGPT, and Cursor, or use a local stdio setup via npm. The server supports both high-level semantic queries and a precise fetch mode for retrieving specific filing sections. Developers can integrate these capabilities into custom applications using the provided TypeScript or Python SDKs. The service offers a free tier with a trial period allowing up to 5,000 API calls per hour.
What you can do with it
- 1Verify corporate risk disclosuresAsk an agent to find specific supply-chain risk mentions in a company's latest 10-K filing with direct links.
- 2Retrieve specific regulatory articlesSearch through EU financial regulations like MiCA or DORA for precise article-level citations.
Written from the project's README. Every use case is checked against a quote from it.
How to install Aether MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Aether MCP in Claude Code
$ claude mcp add aether-developer -- npx -y @evidinvest/aether-mcpInstall Aether MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"aether-developer": {
"command": "npx",
"args": [
"-y",
"@evidinvest/aether-mcp"
]
}
}
}Install Aether MCP in VS Code
.vscode/mcp.json
{
"servers": {
"aether-developer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@evidinvest/aether-mcp"
]
}
}
}Install Aether MCP in VS Code CLI
$ code --add-mcp '{"name":"aether-developer","type":"stdio","command":"npx","args":["-y","@evidinvest/aether-mcp"]}'Install Aether MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"aether-developer": {
"command": "npx",
"args": [
"-y",
"@evidinvest/aether-mcp"
]
}
}
}Install Aether MCP in Codex
$ codex mcp add aether-developer -- npx -y @evidinvest/aether-mcpInstall Aether MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.aether-developer] command = "npx" args = ["-y", "@evidinvest/aether-mcp"]
Install Aether MCP in Gemini CLI
$ gemini mcp add -s user aether-developer npx -- -y @evidinvest/aether-mcpInstall Aether MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"aether-developer": {
"command": "npx",
"args": [
"-y",
"@evidinvest/aether-mcp"
]
}
}
}Configuration
AETHER_API_KEYOptional Aether API key (ak_…). If unset, the package runs OAuth 2.0 device flow on first run. Get keys at https://aether.evidinvest.com/developer/keys.
| Name | Description | |
|---|---|---|
| AETHER_API_KEY | Optional Aether API key (ak_…). If unset, the package runs OAuth 2.0 device flow on first run. Get keys at https://aether.evidinvest.com/developer/keys. |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableevidinvest/aether-developer is public and reachablegithub.com/evidinvest/aether-developer ↗Pass
- Package names this repository as its source@evidinvest/aether-mcp names evidinvest/aether-developer as sourcenpmjs.com/package/@evidinvest/aether-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-11github.com/evidinvest/aether-developer ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @evidinvest/aether-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 492 msPass
README
View on GitHubaether-developer
Everything you need to connect Aether — the search engine built for agents, over SEC filings, earnings-call transcripts, and EU financial regulation — to your LLM, your IDE, or your own code.
Every result is a ready-to-cite evidence payload: the exact filed passage, an accession-numbered citation, the sec.gov / EUR-Lex link, and a confidence score. No filing, no answer — your agent stops inventing numbers.
aether-developer/
├── docs/ — connection guides + REST API reference
│ ├── chatgpt.md — ChatGPT Developer Mode setup
│ ├── mcp.md — Claude / Cursor / Cline / any MCP client
│ ├── cursor.md — Cursor specifics (one-click install)
│ └── search.md — REST API reference (/v1/tools/*), the issuer contract, fetch mode
├── skills/ — Agent Skills (drop into ~/.claude/skills)
├── mcp/ — @evidinvest/aether-mcp (stdio MCP server, npm)
├── clients/
│ ├── typescript/ — @evidinvest/aether-sdk (npm)
│ └── python/ — evidinvest-aether-sdk (PyPI)
└── examples/ — runnable demos + config snippets
Connect your LLM (no code)
MCP endpoint: https://api.aether.evidinvest.com/mcp · Auth: OAuth
(sign in when your client prompts — free account).
| Client | How | Guide |
|---|---|---|
| ChatGPT | Settings → Apps & Connectors → Developer mode → Create connector with the URL above | docs/chatgpt.md |
| Claude (web/Desktop) | Settings → Connectors → Add custom connector with the URL above | docs/mcp.md |
| Claude Code | claude mcp add --transport http aether https://api.aether.evidinvest.com/mcp |
docs/mcp.md |
| Cursor | docs/cursor.md |
|
| Cline / Continue / other stdio MCP | npx -y @evidinvest/aether-mcp in the client's MCP config |
docs/mcp.md |
Then ask: "What does Apple's latest 10-K say about supply-chain risk?
Quote the passage with the sec.gov link." Name the company in the
question — every tool takes an issuer, and naming it is what makes the
answer scoped rather than a relevance-ranked sweep of every filer.
Teach your agent the craft (skills)
MCP gives the agent the tools; the skills/ directory teaches
it the craft — tool routing, citation discipline, point-in-time transcript
retrieval:
cp -r skills/aether-research ~/.claude/skills/ # Claude Code, personal
See skills/README.md for Claude Desktop / other
frameworks.
Call the API from code
Four REST endpoints — the same tools MCP exposes (full reference):
POST /v1/tools/search ← start here (unified)
POST /v1/tools/financial_search POST /v1/tools/transcript_search POST /v1/tools/regulation_search
Name the company, then narrow. Pass issuer on every call and the answer
is scoped to that filer: fast and precise. Omit it and the call searches every
issuer at once — slower, relevance-ranked only, and the response carries a
quality_caveat. scope: "issuer" with no caveat is the only guarantee
you got a filtered answer, so read both fields.
And query is optional: omit it, pass an identifier plus form_type /
fiscal_year / section, and you get fetch mode — that filing's sections
in filing order, no ranking, mode: "fetch", tens of milliseconds. If you
already know which document you want, don't rank it.
TypeScript / Node
pnpm add @evidinvest/aether-sdk
import { AetherClient } from "@evidinvest/aether-sdk";
const aether = new AetherClient({ apiKey: process.env.AETHER_API_KEY });
// search: the question in `query`, the company in `issuer`
const out = await aether.financialSearch({
query: "supply-chain concentration risk",
issuer: { ticker: "AAPL" },
fiscal_year: 2025,
limit: 5,
});
if (out.quality_caveat) console.warn(out.scope, out.quality_caveat);
for (const c of out.results) {
const start = c.metadata?.retrieval?.body_offset ?? 0; // skip the EDGAR cover page
console.log(c.citation, c.metadata?.source_url, c.text.slice(start, start + 200));
}
// fetch: no query — Apple's latest 10-K risk factors, in filing order
const risks = await aether.financialSearch({
issuer: { ticker: "AAPL" },
form_type: ["10-K"],
section: "Item 1A",
limit: 5,
});
console.log(risks.mode); // "fetch" — and no `confidence` on any hit
Python
pip install evidinvest-aether-sdk
from aether import AetherClient
with AetherClient(api_key="ak_...") as aether:
out = aether.financial_search(
query="supply-chain concentration risk",
issuer={"ticker": "AAPL"},
fiscal_year=2025,
limit=5,
)
if out.quality_caveat:
print(out.scope, out.quality_caveat)
for c in out.results:
start = c.body_offset or 0 # skip the EDGAR cover page
print(c.citation, c.metadata.get("source_url"), c.text[start : start + 200])
# fetch: no query — Apple's latest 10-K risk factors, in filing order
risks = aether.financial_search(
issuer={"ticker": "AAPL"}, form_type=["10-K"], section="Item 1A", limit=5
)
print(risks.mode) # "fetch" — and `confidence` is None on every hit
curl / any language
curl -sS https://api.aether.evidinvest.com/v1/tools/search \
-H "authorization: Bearer $AETHER_API_KEY" \
-H "content-type: application/json" \
-d '{"query":"supply chain risk Taiwan","issuer":{"ticker":"TSM"},"limit":5}' | jq .
Docs
docs/search.md— REST API reference: all three tools, params, response shape.docs/regulation_search.md— EU financial-regulation search deep-dive (29 acts), filters, curl.docs/mcp.md— connect any MCP client (remote URL or stdio), env overrides.docs/chatgpt.md— ChatGPT Developer Mode walkthrough.docs/cursor.md— Cursor one-click install.
Get an API key
https://aether.evidinvest.com/developer/keys — anonymous calls work but are rate-limited; keys are free.
What's in the corpus
- SEC filings — 10-K / 10-Q / 8-K, registration statements, prospectuses, press exhibits; ~10 years of S&P 500 and beyond.
- Non-US registries — Sweden (Bolagsverket), Japan (EDINET),
Korea (DART) annual reports. Reach a non-US filer by name —
issuer: {company_name: "Sivers Semiconductors"}— or scope a whole market withjurisdiction: ["SE"|"JP"|"KR"]. - Earnings calls — speaker-attributed transcripts + furnished press
exhibits, with point-in-time filters (
order: "earliest"finds first mentions) and the issuer's ownfiscal_year+quarter. - EU regulation — MiFID II, MiCA, DORA, the AML package; article-level citations.
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 the /v1/tools/* endpoints. Porting to Go,
Rust, Java, etc. is ~150 lines. Open a PR under clients/<lang>/. Whatever you
write, surface scope, quality_caveat, mode and each hit's body_offset:
a client that drops them leaves its users unable to tell a precise answer from
an approximate one. Response fixtures to test against live in
clients/fixtures/.
License
Apache-2.0 — see LICENSE.
Aether MCP questions
How do I add Aether MCP to Claude Code?
Run claude mcp add aether-developer -- npx -y @evidinvest/aether-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Aether MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I connect Aether to my LLM?
You can connect via an MCP endpoint using OAuth, or use the provided guides for ChatGPT, Claude, Cursor, and Cline.
What kind of financial documents are included in the search?
The corpus includes SEC filings like 10-K and 10-Q, earnings call transcripts, and EU financial regulations such as MiFID II and MiCA.
Does Aether provide citations for its answers?
Yes, every result includes a ready-to-cite evidence payload containing the exact passage, an accession-numbered citation, and a link.
Is there a free tier available?
Yes, you can get an API key for free, and new users receive 3 months of a trial tier allowing up to 5,000 API calls per hour.