{"name":"io.github.EvidInvest/aether-developer","slug":"evidinvest-aether-developer","title":null,"description":"Cited search over SEC filings, earnings transcripts and EU regulation, with fetch mode. 14 tools.","url":"https://mcp.market/server/evidinvest-aether-developer","rating":null,"grade":"A","score":90,"certified":false,"status":"active","category":"search","tags":["search"],"presence":{"score":30,"stars":0,"forks":0,"downloads_week":103,"last_push_at":"2026-09-11T19:50:15.000Z","license":"Apache-2.0"},"uptime":{"percent":100,"checks":1,"ok":1,"last_checked_at":"2026-09-19T16:51:12.836Z","last_ok_at":"2026-09-19T16:51:12.836Z","latency_ms":1809},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/EvidInvest/aether-developer","website":null,"version":"0.3.4","remotes":[{"type":"streamable-http","url":"https://aether.evidinvest.com/mcp","headers":[{"description":"Bearer <AETHER_API_KEY> — free key at https://aether.evidinvest.com/developer/register (anonymous calls allowed at 5/hour)","isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"npm","identifier":"@evidinvest/aether-mcp","version":"0.3.3","transport":{"type":"stdio"},"environmentVariables":[{"description":"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.","name":"AETHER_API_KEY"}]}],"tools":[{"name":"financial_search","description":"Search SEC filings (10-K, 10-Q, 8-K, registration statements/prospectuses and press exhibits; S&P 500 coverage, ~10 years) with hybrid semantic + keyword retrieval. TWO MODES. Search mode (pass `query`): results ranked by relevance, highest first. FETCH MODE (omit `query`): no ranking at all — pass an issuer plus any of form_type / fiscal_year / accession_number / section and get that filing's sections back in filing-date-desc then document order, in tens of milliseconds. Use fetch when you already know WHICH document you want and only need its text. ALWAYS pass `issuer` (ticker, cik or company_name) — the company the question is about — plus `fiscal_year` and/or `form_type` when you know them. Scoped calls are fast and precise. A call with no issuer runs as scope=cross_company: slower, ranked by relevance only, and the response sets `quality_caveat` — check for that field. Use scope=cross_company deliberately only for questions that are genuinely about many companies (\"which filers name NVIDIA as a supplier\"). Built for agents: every hit is a ready-to-cite payload — exact filing-section text, form type, filing date, accession-numbered citation, source URL and a 0-1 confidence score — no HTML parsing, no EDGAR pagination. Use for revenue/segment figures, risk factors, M&A and contract terms, customer/supplier concentration, and any claim that must trace to a primary source. Coverage is NOT US-only: Sweden/Bolagsverket, Japan/EDINET, Korea/DART annual reports are included. Those issuers have no US ticker — pass `issuer.company_name` (e.g. \"Sivers Semiconductors\", \"Samsung Electronics\", \"Ajinomoto\") or scope a whole market with `jurisdiction` ([\"SE\"], [\"JP\"], [\"KR\"]).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Natural language search query. OMIT IT for fetch mode: with no query nothing is embedded or scored and the matching sections come back in filing-date-desc then document order. Fetch mode requires an identifier (issuer.ticker / issuer.cik / issuer.company_name / cik[] / accession_number) — a query-less call without one is rejected."},"issuer":{"type":"object","description":"The company the question is about. Pass at least one of ticker (e.g. \"NVDA\"), cik (e.g. \"1045810\"), or company_name (required for non-US issuers, which have no US ticker). Scopes retrieval to that filer: fast and precise. Strongly recommended on every call, and REQUIRED in fetch mode.","properties":{"ticker":{"type":"string","description":"US ticker symbol."},"cik":{"type":"string","pattern":"^(CIK\\s*)?\\d{1,10}$","description":"SEC CIK, any padding."},"company_name":{"type":"string","description":"Legal or common company name; the route for non-US issuers."}}},"fiscal_year":{"oneOf":[{"type":"integer","minimum":1990,"maximum":2100},{"type":"array","items":{"type":"integer","minimum":1990,"maximum":2100},"minItems":1,"maxItems":10}],"description":"Issuer's fiscal year as the company labels it (NVIDIA FY2027 = year ending Jan 2027). Resolved from XBRL DEI fiscal-year focus where available, else from the issuer's fiscal year-end; an empty year widens ±1 with a caveat."},"scope":{"type":"string","enum":["issuer","cross_company"],"default":"issuer","description":"issuer (default): results limited to the resolved company. cross_company: search all filers — for questions like \"who names NVIDIA as a supplier\". Cross-company results are slower, relevance-ranked only, and always carry `quality_caveat`."},"domain":{"type":"string","enum":["public_equity","supply_chain","auto"],"default":"auto","description":"public_equity = single-company filing search; supply_chain = cross-company supplier/customer relationship evidence; auto (default) = detect from the query."},"limit":{"type":"number","default":10,"maximum":50},"fields":{"type":"array","items":{"type":"string"}},"profile":{"type":"string","enum":["bm25","hybrid","hybrid_rerank","hybrid_rerank_tickerprior"],"default":"hybrid","description":"Retrieval profile. `hybrid` (default) ranks by the engine's own fused score (saturated lexical + vector cosine), highest first. `bm25` is the lexical-only fallback. `hybrid_rerank` and `hybrid_rerank_tickerprior` are accepted as aliases of `hybrid` for one release — the cross-encoder they named was removed on 2026-09-11."},"return_format":{"type":"string","enum":["section","chunk","both"],"default":"section","description":"Response shape. 'section' (default) returns the full SEC section the matching chunk belongs to. 'chunk' returns the matching window only. 'both' returns both."},"accession_number":{"type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$","description":"Exact SEC accession number. When set, retrieval is hard-scoped to that filing."},"cik":{"type":"array","items":{"type":"string","pattern":"^\\d{1,10}$"},"description":"Exact SEC CIK values to scope retrieval. Values are normalized to 10 digits."},"form_type":{"type":"array","items":{"type":"string"},"description":"Only return these filing forms, for example [\"20-F\"] or [\"6-K\"]."},"section":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":20}],"description":"Filing section(s), matched case-insensitively as a substring of the stored label — \"Item 1A\" matches \"Item 1A. Risk Factors\". In fetch mode this is how you ask for one part of a filing."},"exclude_form_type":{"type":"array","items":{"type":"string"},"description":"Exclude filing forms. Company searches already suppress fund/proxy forms by default."},"prefer_recent":{"type":"boolean","description":"Prefer newer filings when relevance scores are close. Automatically enabled for latest/current/guidance queries."},"jurisdiction":{"type":"array","items":{"type":"string"},"description":"Scope to non-US issuer jurisdictions (ISO-3166 alpha-2): \"SE\" (Sweden/Bolagsverket), \"JP\" (Japan/EDINET), \"KR\" (Korea/DART). These carry no US ticker and are otherwise buried by SEC-centric ranking. US filings have an empty jurisdiction tag, so this filter is for non-US scoping only — omit it to include US (the default). A named non-US issuer surfaces even without this filter, via the company-name anchor."}},"required":[]}},{"name":"holdings_by_manager","description":"What a fund owns: an institutional manager's reported equity book from SEC Form 13F — top positions by value, with quarter-over-quarter share changes and new/increased/decreased flags. Answers 'what does Bridgewater hold', 'what did this fund buy last quarter', 'show me their largest positions'. Look up by manager name (partial match; the largest matching filer wins, since names like 'Vanguard' map to several distinct CIKs) or by exact CIK. Also returns the filer's published contact details — signatory, title, phone, and business address from the filing's cover page and signature block, each citable to the accession number. EDGAR publishes no email address for 13F filers, so none is returned and none should be inferred. Coverage: quarter ends from 2024-12-31 through 2026-06-30; the newest quarter is still filling in as filers submit, and a manager who has not filed it yet falls back to their most recent quarter, named in coverage_caveat. 13F covers US-listed long equity and options only — no shorts, cash, bonds or non-US listings — and is filed 45 days after quarter end, so it is a lagged snapshot, not a live portfolio.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"manager":{"type":"string","description":"Manager name, partial match, e.g. 'Bridgewater' or 'BlackRock'. Largest matching filer wins."},"cik":{"type":"string","description":"Exact 10-digit filer CIK, e.g. 0002012383. Preferred when known."},"issuer":{"type":"object","description":"The company the question is about, in the same shape financial_search and search take — so an agent can carry ONE issuer object across tools. Alias only: `issuer.cik` fills in `cik` and `issuer.company_name` fills in `manager` when you have not set them. NOTE this tool identifies the FILING MANAGER, not the issuer held — for who owns a stock, use holdings_by_security. Ownership is a structured lookup, so there is no scope or quality_caveat here — `coverage_caveat` is this tool's equivalent.","properties":{"ticker":{"type":"string","description":"US ticker symbol."},"cik":{"type":"string","pattern":"^(CIK\\s*)?\\d{1,10}$","description":"SEC CIK."},"company_name":{"type":"string","description":"Legal or common company name."}}},"period":{"type":"string","description":"Quarter end as YYYY-MM-DD. Defaults to the most recent loaded quarter."},"limit":{"type":"number","description":"Positions to return, 1-200 (default 25), ranked by value."}},"additionalProperties":false}},{"name":"holdings_by_security","description":"Who owns a stock: institutional holders of a security from SEC Form 13F, ranked by position value, with quarter-over-quarter share changes. Answers 'who are the largest holders of NVDA', 'which funds added or trimmed this quarter', 'did anyone initiate a new position'. Give a ticker (resolved via CUSIP) or a CUSIP directly. Each holder row carries its accession number and an EDGAR source_url so the figure is verifiable against the primary filing. Coverage: quarter ends from 2024-12-31 through 2026-06-30, all ~10,000 filing managers, not just large ones; the newest quarter is still filling in as filers submit, so its holder_count is lower than a settled quarter's. Positions are aggregated per filer CIK — a single 13F contains one line per sub-manager (BlackRock's carries 42 separate NVDA lines), so per-line reading understates holders badly. Amendments are excluded. Note total_value_usd is the sum across filers and may double-count where combination reports include other managers' holdings; coverage_caveat flags this when relevant. 13F covers US-listed long equity and options only — it does not show shorts, cash, bonds, or non-US listings, and is filed 45 days after quarter end.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker, e.g. NVDA. Resolved to a CUSIP internally."},"cusip":{"type":"string","description":"9-character CUSIP, e.g. 67066G104. Use when the ticker is unmapped."},"issuer":{"type":"object","description":"The company the question is about, in the same shape financial_search and search take — so an agent can carry ONE issuer object across tools. Alias only: `issuer.ticker` fills in `ticker` when you have not set it. Ownership is a structured lookup, so there is no scope or quality_caveat here — `coverage_caveat` is this tool's equivalent.","properties":{"ticker":{"type":"string","description":"US ticker symbol."},"cik":{"type":"string","pattern":"^(CIK\\s*)?\\d{1,10}$","description":"SEC CIK."},"company_name":{"type":"string","description":"Legal or common company name."}}},"period":{"type":"string","description":"Quarter end as YYYY-MM-DD, e.g. 2026-03-31. Defaults to the most recent loaded quarter."},"limit":{"type":"number","description":"Holders to return, 1-100 (default 20), ranked by value."}},"additionalProperties":false}},{"name":"list_partners","description":"List active marketplace partners (sellers) and what each offers. Each partner has zero or more 'modes': `indexed` (free queries via partner_search against published documents) and/or `proxy` (queries routed server-to-server to the seller's own API via partner_proxy_search, consuming prepaid Aether credits per call). Use the returned per-call credit costs to budget calls before invoking partner_proxy_search.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"ticker":{"type":"string","description":"Optional — filter to partners that cover this ticker (either in indexed docs or proxy endpoints)."},"mode":{"type":"string","enum":["indexed","proxy","any"],"default":"any","description":"Restrict to partners offering this mode."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"additionalProperties":false}},{"name":"partner_proxy_search","description":"Route the agent's query server-to-server to one or more seller-registered API endpoints. Each call consumes prepaid Aether credits from the connected account at the per-call rate listed in list_partners (consumed regardless of result count). Aether holds seller credentials — agent never sees URL or token. Pass `issuer` when the question is about one company, so routing narrows to the endpoints that declare coverage of it rather than guessing the ticker from the query text — a wrong guess here spends credits on the wrong endpoint. Use list_partners first to discover available endpoints and per-call credit costs.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string"},"partners":{"type":"array","items":{"type":"string"},"description":"Seller slugs to route to. Empty/omitted = no fan-out (you MUST pick partners explicitly for credits to be consumed — no surprise charges)."},"endpoints":{"type":"array","items":{"type":"string"},"description":"Optional: scope to specific endpoint slugs (format `<seller>/<endpoint>`). Otherwise all active endpoints of the named partners."},"issuer":{"type":"object","description":"The company the question is about. Pass `ticker` to route only to endpoints that declare coverage of it, instead of relying on ticker detection over the query text.","properties":{"ticker":{"type":"string","description":"US ticker symbol."},"cik":{"type":"string","pattern":"^(CIK\\s*)?\\d{1,10}$","description":"SEC CIK. Accepted for symmetry; endpoint coverage is declared by ticker."},"company_name":{"type":"string","description":"Company name. Accepted for symmetry; endpoint coverage is declared by ticker."}}},"ticker_filter":{"type":"boolean","description":"Legacy switch, still accepted. When true (default) and an issuer is known — passed in `issuer` or recognized in the query — route only to endpoints covering that ticker. false disables the filter entirely."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"confirm_charge":{"type":"boolean","description":"Safety acknowledgement. Must be true to actually execute the call. If false (or omitted), returns a dry-run quote with estimated charges.","default":false}},"required":["query","partners"],"additionalProperties":false}},{"name":"partner_search","description":"Search marketplace partner documents (research notes, supply-chain analyses, etc. published by registered sellers). Returns ranked chunks with explicit per-document attribution and license terms. Pass `issuer` when the question is about one company — partner documents declare ticker coverage, so a named issuer narrows to the documents that actually cover it; without one the call runs scope=cross_company over every seller's corpus and the response sets `quality_caveat`. Use list_partners first to discover available sellers + filter via the `partners` arg to scope costs.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Natural-language search query."},"partners":{"type":"array","items":{"type":"string"},"description":"Optional list of seller slugs to scope the search to. Empty/omitted = all active sellers."},"doc_types":{"type":"array","items":{"type":"string"},"description":"Optional filter on doc_type field — e.g. ['research_note', 'supply_chain']."},"issuer":{"type":"object","description":"The company the question is about. Pass `ticker` to filter to documents that declare coverage of it, instead of relying on ticker detection over the query text.","properties":{"ticker":{"type":"string","description":"US ticker symbol."},"cik":{"type":"string","pattern":"^(CIK\\s*)?\\d{1,10}$","description":"SEC CIK. Accepted for symmetry; partner coverage is declared by ticker."},"company_name":{"type":"string","description":"Company name. Accepted for symmetry; partner coverage is declared by ticker."}}},"scope":{"type":"string","enum":["issuer","cross_company"],"default":"issuer","description":"issuer (default): narrow to documents covering the named issuer. cross_company: search every seller's whole corpus — always carries `quality_caveat`. Setting it drops the ticker filter."},"ticker_filter":{"type":"boolean","description":"Legacy switch, still accepted. When true (default) and an issuer is known — passed in `issuer` or recognized in the query — filter to docs covering that ticker. false disables the filter entirely."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"profile":{"type":"string","enum":["bm25","hybrid"],"default":"hybrid"}},"required":["query"],"additionalProperties":false}},{"name":"regulation_search","description":"Search the text of EU financial regulation — a 29-act corpus (~13,000 citable chunks) covering markets & securities (MiFID II, MiFIR, MAR, Prospectus, EMIR, CSDR, Short-Selling, SFTR, Benchmarks), crypto & operational resilience (MiCA, DORA), banking & prudential (CRR, CRD IV, BRRD, SRMR), funds (UCITS, AIFMD), payments & insurance (PSD2, Solvency II, IDD), sustainable finance (SFDR, Taxonomy, CSRD), the 2024 EU AML package (AMLR, AMLAR, AMLD6, Transfer-of-Funds Regulation), plus Credit Rating Agencies and GDPR. Returns ranked, citable units — Article-paragraphs, recitals, annex blocks — each with a human breadcrumb (e.g. 'MiCA 2023/1114 · Art. 4 · para. 1' or 'AMLR 2024/1624 · Art. 12 · para. 3'). Scoped to financial regulation, not all EU law. ALWAYS pass `celex` — it is this corpus's anchor, the equivalent of naming the issuer on a filing search — plus `article` when you know it. An anchored call is scope=issuer: fast and precise. With no `celex` the call runs scope=cross_company across all 29 acts, ranked by relevance only, and the response sets `quality_caveat` — check for that field. Use scope=cross_company deliberately for genuinely corpus-wide questions (\"which acts impose a 72-hour incident-reporting deadline\"). Narrow further with doc_type, chunk_type or AML topic; set prefer_consolidated to favour EUR-Lex consolidated text over the original OJ text.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Natural language query"},"celex":{"type":["string","array"],"items":{"type":"string"},"description":"The act(s) to anchor on, by CELEX number — e.g. 32014L0065 (MiFID II), 32023R1114 (MiCA), 32013R0575 (CRR), 32022R2554 (DORA), 32016R0679 (GDPR), 32024R1624 (AMLR). This is the subject of the call: pass it whenever you know which act you mean. Omitting it searches the whole 29-act corpus as scope=cross_company, with a quality_caveat."},"scope":{"type":"string","enum":["issuer","cross_company"],"default":"issuer","description":"issuer (default, requires `celex`): results come from that act only. cross_company: the whole corpus — slower, relevance-ranked only, always carries `quality_caveat`. A `celex` filter you pass always applies."},"doc_type":{"type":"string","description":"Optional filter: regulation | directive | rts | its | decision"},"article":{"type":"string","description":"Optional single-article filter, e.g. \"20\" or \"12a\""},"chunk_type":{"type":"string","description":"Optional filter: paragraph | article_intro | recital | table | annex"},"aml_topics":{"type":["string","array"],"items":{"type":"string"},"description":"Optional topic tag filter: cdd | edd | pep | str_reporting | governance | reporting | transaction_monitoring"},"prefer_consolidated":{"type":"boolean","description":"Prefer EUR-Lex consolidated text over original OJ text at equal relevance (hybrid only). Leave off to favor the as-published OJ text."},"limit":{"type":"number","default":10,"maximum":50},"profile":{"type":"string","enum":["bm25","hybrid"],"default":"hybrid"}},"required":["query"]}},{"name":"search","description":"Unified search across every Aether corpus at once — SEC filings, Japan/EDINET and Korea/DART annual reports, EU financial regulation, and earnings calls/press-release exhibits — auto-routed and merged into one corpus-tagged, citation-complete result set. Use this for MOST questions: you do NOT have to pick the right corpus, and it will not miss same-day earnings (8-K earnings exhibits live in the transcript/press corpus, which a filings-only search silently misses). Each hit carries a `corpus` tag, an accession/citation string, a source URL, a 0-1 confidence score and an anchor_id. ALWAYS pass `issuer` (ticker, cik, or company_name for non-US filers) plus `fiscal_year` when you know it — it is forwarded to every corpus, so one named subject scopes filings and earnings calls together: fast and precise. A call with no issuer runs as scope=cross_company: slower, ranked by relevance only, and the response sets `quality_caveat` — check for that field before trusting the result. Use scope=cross_company deliberately, only for questions genuinely about many issuers (\"which filers name NVIDIA as a supplier\"). Filters are forwarded, not dropped: form_type / accession_number / section / return_format reach the filing corpora (sec/jp/kr), quarter and fiscal_year reach the earnings-call corpus, and EU regulation takes none of them (it has no issuer, form or quarter) — a filing filter therefore narrows an omitted `corpora` to sec/jp/kr. Any field not listed here is REJECTED with a 400 naming it, rather than silently ignored. Reach for financial_search / transcript_search / regulation_search only when you deliberately want to force a single corpus. Ownership questions do not go through search at all: holdings_by_security and holdings_by_manager.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Natural language search query. OPTIONAL — omit it (or pass an empty string) to select FETCH MODE, which ranks nothing and returns rows in filing order. Fetch mode REQUIRES an identifier: pass `issuer` (ticker, cik or company_name) or a single-element `tickers`, optionally narrowed with `fiscal_year`; a query-less call with no identifier is rejected. Fetch fans out to sec/jp/kr/transcripts only — EU regulation has no issuer, so \"every article, newest first\" answers nothing."},"issuer":{"type":"object","description":"The company the question is about. Pass at least one of ticker (e.g. \"NVDA\"), cik (e.g. \"1045810\"), or company_name (required for non-US issuers, which have no US ticker). Forwarded to every corpus that can use it. Strongly recommended on every call.","properties":{"ticker":{"type":"string","description":"US ticker symbol."},"cik":{"type":"string","pattern":"^(CIK\\s*)?\\d{1,10}$","description":"SEC CIK, any padding."},"company_name":{"type":"string","description":"Legal or common company name; the route for non-US issuers."}}},"fiscal_year":{"oneOf":[{"type":"integer","minimum":1990,"maximum":2100},{"type":"array","items":{"type":"integer","minimum":1990,"maximum":2100},"minItems":1,"maxItems":10}],"description":"Issuer's fiscal year as the company labels it (NVIDIA FY2027 = year ending Jan 2027). Forwarded verbatim to every corpus: on filings it is resolved from XBRL DEI fiscal-year focus where available, else from the issuer's fiscal year-end; on earnings calls it is that corpus's own labelled fiscal year. An empty year widens ±1 with a caveat."},"scope":{"type":"string","enum":["issuer","cross_company"],"default":"issuer","description":"issuer (default): every corpus is scoped to the named company. cross_company: search all issuers — for questions like \"who names NVIDIA as a supplier\". Cross-company results are slower, relevance-ranked only, and always carry `quality_caveat`."},"tickers":{"type":"array","items":{"type":"string"},"description":"Legacy alias of `issuer`, still accepted. One symbol (e.g. [\"IBM\"]) is read as issuer.ticker; several (e.g. [\"IBM\", \"MU\"]) is a cross-company question and is labelled scope=cross_company, though the filter to those companies still applies. Prefer `issuer`."},"limit":{"type":"integer","default":10,"maximum":50,"description":"Max hits to return (1-50, default 10)."},"corpora":{"type":"array","items":{"type":"string","enum":["sec","jp","kr","regulation","transcripts"]},"description":"Optional corpus filter. Omit to search everything (recommended). Values: sec, jp, kr, regulation, transcripts. An explicit value always wins: a filing filter (form_type / accession_number / section) narrows an OMITTED fan-out to sec/jp/kr, but naming corpora here overrides that."},"form_type":{"type":"array","items":{"type":"string"},"description":"Only return these filing forms, for example [\"20-F\"] or [\"6-K\"]. Forwarded to the filing corpora (sec/jp/kr). Because an earnings segment has no form type and an EU article has none either, setting this ALSO narrows an omitted `corpora` to sec/jp/kr rather than merging rows the filter could not reach."},"accession_number":{"type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$","description":"Exact SEC accession number. When set, the filing corpora are hard-scoped to that filing, and an omitted `corpora` narrows to sec/jp/kr. It also counts as the identifier fetch mode requires, so `{accession_number}` with no `query` is a legal fetch."},"section":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":20}],"description":"Filing section(s), matched case-insensitively as a substring of the stored label — \"Item 1A\" matches \"Item 1A. Risk Factors\". In fetch mode this is how you ask for one part of a filing. Filing corpora only; it narrows an omitted `corpora` to sec/jp/kr."},"quarter":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":8}],"description":"Fiscal quarter(s) — \"Q2\" or [\"Q1\",\"Q2\"]. Exact, case-insensitive. Applies to the EARNINGS-CALL corpus only (with issuer.ticker and fiscal_year it names one call, the natural fetch-mode request); the filing and regulation corpora ignore it."},"return_format":{"type":"string","enum":["section","chunk","both"],"default":"chunk","description":"Response shape for the filing corpora. \"chunk\" (the unified default) returns the matching window only — it keeps a five-corpus merge small. \"section\" returns the full SEC section the chunk belongs to, \"both\" returns both. The earnings-call and regulation corpora ignore it; their unit is a speaker turn / an article."}},"required":[]}},{"name":"seller_list_my_documents","description":"List documents this seller has published. Returns status (pending / indexed / failed / revoked) and the indexed chunk count (`indexed_chunk_count`; the legacy alias `vespa_chunk_count` carries the same value for one release).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"seller_api_key":{"type":"string"}},"required":["seller_api_key"],"additionalProperties":false}},{"name":"seller_list_my_endpoints","description":"List proxy endpoints this seller has registered. Secrets are never returned — only a `secret_configured` boolean.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"seller_api_key":{"type":"string"}},"required":["seller_api_key"],"additionalProperties":false}},{"name":"seller_publish_document","description":"Publish (or update) a document into the marketplace. The content is chunked + embedded + indexed by a background worker; status moves from `pending` to `indexed` once that completes. Re-publishing the same external_doc_id replaces the prior version. Account must be status='active' for the worker to index; pending_review accounts queue indefinitely.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"seller_api_key":{"type":"string","description":"Your seller API key (aether_sk_…)."},"external_doc_id":{"type":"string"},"title":{"type":"string"},"doc_type":{"type":"string"},"license":{"type":"string"},"ticker_coverage":{"type":"array","items":{"type":"string"}},"content":{"type":"string","description":"Document text. Up to ~2 MB."},"source_url":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}},"required":["seller_api_key","external_doc_id","content"],"additionalProperties":false}},{"name":"seller_register_endpoint","description":"Register a proxy endpoint (Mode B). Aether stores your auth secret encrypted at rest (AES-256-GCM) and routes agent queries server-to-server — agents never see your URL or token. Charge per call via the `price_per_call_usd_cents` field. Account must be status='active' for traffic to be routed.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"seller_api_key":{"type":"string"},"slug":{"type":"string","description":"lowercase kebab-case; unique per seller"},"display_name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"http_method":{"type":"string","enum":["POST","GET"]},"auth_method":{"type":"string","enum":["bearer","header","basic","none"]},"secret":{"type":"string","description":"Encrypted at rest; never returned."},"auth_header_name":{"type":"string","description":"Required when auth_method='header'."},"pricing_model":{"type":"string","enum":["free","per_call","subscription"]},"price_per_call_usd_cents":{"type":"integer","minimum":0},"monthly_request_cap":{"type":"integer","minimum":1},"taxonomy_tags":{"type":"array","items":{"type":"string"}},"ticker_coverage":{"type":"array","items":{"type":"string"}},"response_jsonpath":{"type":"string","description":"e.g. $.results"},"request_template":{"type":"object","additionalProperties":true}},"required":["seller_api_key","slug","display_name","url"],"additionalProperties":false}},{"name":"seller_signup","description":"Create a new marketplace seller account. Returns an API key (shown once). New accounts default to status='pending_review' — they can publish documents and register endpoints, but content is not surfaced in search until ops approves the account. Use the `invite_code` arg if the operator gave you one to bypass review.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"slug":{"type":"string","description":"Lowercase kebab-case identifier shown in attribution."},"org_name":{"type":"string"},"contact_email":{"type":"string"},"description":{"type":"string","description":"Free-text description shown to agents in list_partners."},"invite_code":{"type":"string","description":"Optional operator-issued invite. Bypasses per-IP rate limit and auto-approves."}},"required":["slug","org_name","contact_email"],"additionalProperties":false}},{"name":"transcript_search","description":"Search earnings-call transcripts and earnings press-release exhibits by speaker turn (CEO/CFO prepared remarks, analyst Q&A, press releases). Returns verbatim quotes as agent-ready payloads: speaker name/role, fiscal year + quarter, call date, source_type (asr_call = our own ASR of the real call vs press_release), sec.gov source URL and citation string. Use for guidance, management tone and forward-looking color that filings don't capture; pair with financial_search to back narrative with filed numbers. ALWAYS pass `issuer` (the ticker whose calls you mean) plus `fiscal_year` when you know it — a named call is scoped to that issuer's calls, fast and precise. A call with no issuer runs as scope=cross_company: slower, ranked by relevance only, and the response sets `quality_caveat` — check for that field. Use scope=cross_company deliberately, only for questions genuinely about many companies (\"which management teams talked about tariff pass-through\"). Narrow further with speaker_role, lookback_quarters or source_type. FETCH MODE: omit `query` entirely and pass issuer.ticker plus fiscal_year / quarter / date_from / date_to to get that call's segments back in call-date-desc then spoken order, with no ranking and in tens of milliseconds — the right tool when you already know WHICH call you want. For onset/\"first mention\" questions (when did a topic first come up), bound with date_from/date_to and set order='earliest' — a date pair, not a fiscal year, is the right tool there.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Natural language query. OMIT IT for fetch mode: with no query nothing is embedded or scored and the matching segments come back newest call first, then in the order they were spoken. Fetch mode requires a ticker."},"issuer":{"type":"object","description":"The company whose calls you mean. Pass `ticker` (e.g. \"NVDA\"); this corpus is keyed on ticker, so that is the field that scopes it. Strongly recommended on every call.","properties":{"ticker":{"type":"string","description":"US ticker symbol."},"cik":{"type":"string","pattern":"^(CIK\\s*)?\\d{1,10}$","description":"SEC CIK. Accepted for symmetry with financial_search; this corpus scopes on ticker."},"company_name":{"type":"string","description":"Reserved for non-US calls once the ASR corpus carries them."}}},"fiscal_year":{"oneOf":[{"type":"integer","minimum":1990,"maximum":2100},{"type":"array","items":{"type":"integer","minimum":1990,"maximum":2100},"minItems":1,"maxItems":10}],"description":"Fiscal year(s) the question concerns — the ISSUER'S OWN fiscal year, as printed on its cover page, matched exactly against each segment's fiscal-year label. Offset-fiscal-year issuers work as stated: NVDA fiscal_year 2027 returns the calls held during calendar 2026, AAPL 2025 the Q1-Q4 FY2025 calls. If the requested year matches nothing the search retries once at ±1 and says so in `quality_caveat`. Independent of date_from/date_to, which bound the CALL DATE and still apply on top."},"scope":{"type":"string","enum":["issuer","cross_company"],"default":"issuer","description":"issuer (default): results limited to the issuer's own calls. cross_company: search every issuer's calls — slower, relevance-ranked only, and always carries `quality_caveat`. Setting it drops the ticker filter, so a caveated answer is never secretly a scoped one."},"ticker":{"type":"string","description":"Optional ticker filter (e.g. NVDA). Legacy alias of `issuer.ticker`."},"lookback_quarters":{"type":"number","description":"Keep calls within last N quarters (default: no filter)"},"speaker_role":{"type":"string","description":"Optional speaker role filter: CEO / CFO / Analyst / Operator"},"date_from":{"type":"string","description":"Point-in-time lower bound on call date, inclusive ISO YYYY-MM-DD"},"date_to":{"type":"string","description":"Point-in-time upper bound on call date, inclusive ISO YYYY-MM-DD"},"order":{"type":"string","enum":["relevance","earliest","latest"],"default":"relevance","description":"Sort order. 'earliest'/'latest' sort matched hits chronologically (use 'earliest' for onset/first-mention queries); 'relevance' sorts by rank score."},"source_type":{"type":"string","enum":["press_release","furnished_transcript","asr_call"],"description":"Provenance filter: asr_call = our ASR of the real call (Q&A); furnished_transcript = issuer transcript exhibit; press_release = 8-K press exhibit."},"quarter":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":8}],"description":"Fiscal quarter(s) — \"Q2\" or [\"Q1\",\"Q2\"]. Exact, case-insensitive. With issuer.ticker and fiscal_year this names one call, which is the natural fetch-mode request."},"limit":{"type":"number","default":10,"maximum":50},"profile":{"type":"string","enum":["bm25","hybrid"],"default":"hybrid"}},"required":[]}}],"scan":{"score":90,"grade":"A","scanned_at":"2026-09-19T20:14:20.887Z","report":{"scannerVersion":"0.1.5","scannedAt":"2026-09-19T20:14:20.856Z","components":{"code":{"score":25,"max":25,"notes":["7 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 757ms"]},"poisoning":{"score":15,"max":15,"notes":["14 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":15,"max":15,"notes":["last push 8 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"probes":[{"url":"https://aether.evidinvest.com/mcp","reachable":true,"authRequired":false,"latencyMs":757,"serverInfo":{"name":"aether-finance","version":"0.2.0"}}],"packages":[{"registryType":"npm","identifier":"@evidinvest/aether-mcp","version":"0.3.3","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":1,"publishedAt":"2026-09-11T19:35:59.644Z","repositoryUrl":"git+https://github.com/EvidInvest/aether-developer.git","weeklyDownloads":103}],"repo":{"found":true,"owner":"EvidInvest","repo":"aether-developer","archived":false,"pushedAt":"2026-09-11T19:50:15Z","stars":0,"forks":0,"openIssues":0,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/269997481?v=4","ownerCreatedAt":"2026-03-21T19:07:19Z","license":"Apache-2.0"},"icon":{"url":"https://aether.evidinvest.com/icon.png?6ecf2776c66f6759","source":"registry","width":256,"height":256},"presence":{"stars":0,"forks":0,"downloadsWeek":103,"license":"Apache-2.0","lastPushAt":"2026-09-11T19:50:15.000Z","score":30}}}},"grade_history":[],"reviews":[]}