SIGNAL8_API_KEY — Signal8 API key (starts with sk_live_ or sk_test_). API keys are included with Signal8 Pro; create one at https://signal8.ai/developer/api-keys.
Yukarıdaki Claude düğmesi, ad ve URL doldurulmuş olarak Claude'u açar. Onayı yine orada siz verirsiniz.
npm install -g @signal8ai/mcp
# or use npx (no install needed)
npx @signal8ai/mcp
Setup
1. Get your API key
API and MCP access are included with Signal8 Pro ($59/mo, or $588/yr). A free Signal8 account cannot create API keys. Upgrade at signal8.ai/pro, then create a key in the developer portal at signal8.ai/developer/api-keys.
Using Claude.ai or Claude Desktop? You can skip the key entirely: add the hosted server as a custom connector and sign in with your Signal8 account (see Hosted Endpoint).
The server exposes 104 live tools at runtime. The reference tables below are
a representative catalog grouped by domain, not an exhaustive list; the
Extractions section documents tools that are currently disabled and not
registered live. The authoritative list is what tools/list returns.
Companies (3 tools)
Tool
Description
search_companies
Search companies by name or ticker
get_company_profile
Full company profile (description, market cap, sector)
get_company_bundle
Consolidated data bundle in one call
Company Data (13 tools)
Tool
Description
get_quote
Real-time stock quote (price, change, volume)
get_market_metrics
Volume averages, volatility, SMAs, trend direction
Upcoming/recent earnings releases between two dates
get_economic_calendar
Macro/economic events (CPI, FOMC, jobs, GDP) by date and country
get_filing_calendar
10-K / 10-Q SEC filing-deadline calendar by universe
get_lockup_expirations
Upcoming IPO/secondary lockup expirations
get_recent_material_filings
Recent material 8-K filings by index universe and item codes
SEC Filings & EDGAR archive (10 tools)
Backed by Signal8's own archive of SEC EDGAR filings — the archive's held
range (see archiveFrom in each response; currently from late 2021, expanding
back to 2016 as the history backfill fills in), full-text indexed and updated
through the day. Filings older than archiveFrom may be absent, so an empty
result is not proof a filing was never made. Record-only rows (bodyStored: false) carry metadata but no body.
Tool
Description
search_sec_filings
Filings by CIK, form, date, 8-K items, excluded forms, full-text q (match exact/stemmed, sort newest/relevance, facets counts by form/year/8-K item, understand on/off, section search, exhibitTypes — see query syntax below), and company filters (market cap, float, price, sector, industry, exchange, company type, foreign issuer, recent IPO)
get_filing_documents
Every document in a filing (type, size, stored, secUrl) with the filingId / exhibitId to read each one
get_filing_structured
Parsed Form 3/4/5 transactions, 13F holdings (values normalised to dollars), XML SCHEDULE 13D/G
Filings across companies by sector / industry / exchange / market cap
screen_sec_filings_performance
Price returns +1/+3/+7/+30 days after filings, with aggregates
Full-text query syntax (search_sec_filings.q, search_filing_text.pattern):
unquoted words must all appear; "quoted phrase" for exact wording; OR
between alternatives; -word to exclude; w1 NEAR/10 w2 (or NEAR(10), bare
NEAR = 10) for proximity; word* for a prefix of 4+ letters; $AAPL or a
capitalised ticker scopes to that company; a form code (8-K), item 5.02 /
8-K 1.05 and a bare year scope to that form / 8-K item / year. Relevance page 1
shows a few filings per company; meta.diversity names who has more. How the archive read the
query is returned in meta.understanding (pass understand: false to search
the words literally). facets: true adds per-form / per-year / per-8-K-item
counts over the whole result set — absent when not measured, never zero.
Section search + exhibit types (both search tools): section restricts
matching to business, risk_factors, cybersecurity, legal_proceedings,
mdna, market_risk, controls, ex99 (press releases) or an 8-K item
(item_5_02); exhibitTypes keeps filings with e.g. EX-10 (material
contracts) or EX-99.1. A section is applied only when meta.sections says
so — otherwise meta.unsupported explains that the whole filing was searched.
Rows may carry matchedSections (absent = not measured).
Company filters on search_sec_filings follow the same rules as the
signal8.ai/sec-filings page: they are applied from the archive only, against
the filer's own CIK, on issuer-filed forms only (Form 4, 144 and SCHEDULE 13D/G
are dropped and reported in companyFilter.droppedForms). Companies with no
measured value for a filter are excluded and counted in companyFilter.unknown.
Unknown values return a 400 listing the valid names. If the archive cannot
answer, the call fails with COMPANY_FILTER_NOT_APPLIED and a reason rather
than returning unfiltered rows.
13F values: the SEC changed the unit of a 13F <value> from thousands of
dollars to whole dollars for filings on/after 2023-01-03.
get_filing_structured returns valueUsd / totalMarketValueUsd normalised to
dollars (null when the unit cannot be determined) next to the raw
valueThousands, and valueUnit says which unit the raw number is in.
Extractions (4 tools)
Tool
Description
get_extractions
AI-extracted SEC filing data (13 types)
get_filing_extractions
Extractions for a specific SEC filing
get_extraction_dashboard
Cross-company extraction analytics
get_extraction_by_type
Filter extractions by type (warrants, convertibles, etc.)
Dilution (7 tools)
Small-cap dilution analysis read directly from SEC filings. Every figure carries the
accession number, filing date and the quoted sentence it came from. Included in
Signal8 Pro. Call get_dilution_coverage first: it
is the cheapest way to learn whether there is anything to fetch.
Tool
Description
get_dilution_coverage
Whether a ticker has a dilution analysis, how fresh it is, and why not if it doesn't
get_dilution_risk
Dilution Pressure Score with its seven-component breakdown and risk levels. A partial score is out of scoreMaxMeasured (never rescale to /100); overheadSupply is total potential dilution excluding shelf (gross warrants/convertibles + ATM/equity line/S-1 at the current price, details.overheadSupplyBasis); levels named in levelsLowerBoundScope are floors ("at least") when levelsAreLowerBound is true; details.levelBounds gives each level's floor, ceiling and best estimate (a level whose floor and ceiling agree is exact)
get_dilution_snapshot
Potential new shares and % of shares outstanding, cash position and runway, float
get_dilution_instruments
One instrument family's rows with per-field SEC citations (warrants, convertibles, preferred, shelfs, atms, elocs, s1_offerings, equity_plans, exchangeables, recent_offerings)
get_baby_shelf_capacity
S-3 I.B.6 baby shelf: how much the issuer can raise off its shelf right now
get_dilution_performance
How the stock traded after each past offering priced or closed
get_dilution_history
Shares-outstanding and cash series with offering overlays
Not measured is not zero. A null, withheld or unavailable figure means Signal8 did
not measure it. It never means the company has no warrants, no shelf or no dilution,
and the tool descriptions tell the model so.
Use the explain_dilution prompt to walk a ticker's dilution picture in plain English.
Intelligence — Per-Company (12 tools)
Tool
Description
get_counterparties
Entity-resolved counterparty relationships
get_counsel
Legal counsel engagements with role taxonomy
get_insiders
Insider trading discovery and patterns
get_ownership
Unified ownership (Form 4 + 13F + 13D/G)
get_rofr_triggers
ROFR exercise trigger detection
get_institutions
Institutional holders from 13F filings
get_institution_detail
Detailed info for a specific institution (by CIK)
get_institution_holdings
Full portfolio holdings for an institution
get_banks
Investment bank relationships from SEC filings
get_legal_counsels
Legal counsel relationships with partner names
get_insider_transactions
Detailed Form 4 transaction history
get_insider_cluster_buys
Cluster buying pattern detection (3+ insiders in 14 days)
Intelligence — Cross-Company (3 tools)
Tool
Description
get_institution_top_aum
Top institutional holders by AUM across all companies
get_counsel_cross_company
Law firm engagements across multiple companies
get_insider_cross_company
Insider trading patterns across multiple companies
Compliance (4 tools)
Tool
Description
get_compliance
Full compliance evaluation
get_deficiencies
Listing deficiency detection
get_compliance_alerts
Active compliance alerts
get_listing_classification
Exchange listing classification
Screener (2 tools)
Tool
Description
get_screener_fields
Discover available screening filters
screen_companies
Dilution-aware company screener
Events & ATM (2 tools)
Tool
Description
get_events
Unified corporate events
get_atm_activity
ATM program monitoring
ETF (1 tool)
Tool
Description
get_etf_bundle
Aggregated ETF data (profile, holdings, sectors, performance)
Market Intelligence — Tool Reference
Cross-ticker market and calendar tools that operate over the entire universe rather than a single company. The single-ticker get_quote tool is included here for completeness; the rest were added in the Market Intelligence rollout.
get_quote
Real-time quote for a single ticker (price, change, volume, day range).
Extended-hours windows (US equities, ET): pre-market 4:00am–9:30am, after-hours 4:00pm–8:00pm. Outside those windows preMarketPrice, preMarketChangePercent, afterHoursPrice, and afterHoursChangePercent are null. In practice only one pair is populated at a time depending on the current window — the second example shows both populated for illustration.
Use case: "What is AAPL trading at right now?"
get_quotes_batch
Fetch real-time quotes for up to 200 tickers in one call. Backed by POST /api/v1/public/market/quotes. Tickers absent from the upstream feed map to null.
Use case: "Show me a one-shot snapshot of where the index ETFs closed."
get_sector_etf_snapshot
Snapshot of the 11 SPDR sector ETFs (XLK, XLF, XLV, XLY, XLP, XLE, XLI, XLB, XLRE, XLU, XLC) with a sector label per row. Useful for sector-rotation views.
Use case: "Which sectors are leading and lagging today?"
get_top_movers
Top market movers by direction (gainers, losers, or most-active by volume), computed from ticker_snapshots. Excludes warrants/units/ETFs/funds.
Inputs:
Name
Type
Required
Description
direction
enum
yes
gainers, losers, or active
limit
integer
no
1–100 (backend default applied when omitted)
session
enum
no
premarket (4:00–9:30 AM ET), regular (default; close-to-close), or afterhours (4:00–8:00 PM ET). Use premarket/afterhours when posting outside RTH so rankings reflect the live window.
Market breadth aggregates (advance/decline counts and ratio, % of constituents trading above their 50DMA / 200DMA, and counts of new 52-week highs/lows) for a chosen universe. Point-in-time only — no historical breadth.
Use case: "What high-impact US events land this week?"
get_filing_calendar
Forward-looking 10-K / 10-Q SEC filing-deadline calendar by index universe. Deadlines computed from each company's last-reported period end + filer-status offset.
Use case: "Which S&P 500 names have a 10-Q deadline in the next two weeks?"
get_lockup_expirations
Upcoming IPO/secondary lockup expirations within a date window. Derived from underwriting-terms extractions (S-1 / F-1 / 424B*) — coverage is partial; check meta.coveragePercent.
Use case: "Any IPO lockup expirations coming up in the next 30 days?"
get_recent_material_filings
Recent 8-K filings flagged as materially significant within a named index universe, optionally filtered by item codes (e.g. 1.01 material agreement, 5.02 leadership change). Lookback fixed at 7 days.
Dilution coverage, score, snapshot and instruments explained in plain English with Signal8 Academy citations
Hosted Endpoint
For web-based MCP clients, use the hosted Streamable HTTP endpoint:
POST https://mcp.signal8.ai/mcp
Authorization: Bearer sk_live_your_key_here
Content-Type: application/json
Clients that support custom bearer-token headers (e.g. Claude Code CLI's
--transport http connector, Cursor, and VS Code's MCP support) can send your
API key as shown above.
Clients that support MCP OAuth need no key at all. In Claude.ai or Claude
Desktop, open Settings → Connectors → Add custom connector, paste
https://mcp.signal8.ai/mcp, and Claude opens a Signal8 sign-in to authorize
the connection. The server advertises its authorization server at
https://mcp.signal8.ai/.well-known/oauth-protected-resource (OAuth 2.1 with
PKCE and dynamic client registration, issued by https://api.signal8.ai).
OAuth connections are subject to the same Signal8 Pro requirement and rate
limits as API keys.
Environment Variables
Variable
Required
Description
SIGNAL8_API_KEY
Yes
Your Signal8 API key (starts with sk_live_ or sk_test_)
SIGNAL8_API_URL
No
API base URL (default: https://api.signal8.ai/api/v1/public)
Pricing
The MCP server and the REST API it calls are included with Signal8 Pro
($59/mo, or $588/yr) at 120 requests per minute and 10,000 requests per
day, with up to 3 API keys. There are no per-call credits or per-request
charges: every request the server makes to the Signal8 API counts once against
those limits. Free Signal8 accounts do not include API or MCP access. See
signal8.ai/developer.
Programmatic Usage
import { createMcpServer, Signal8ApiClient } from '@signal8ai/mcp';
const client = new Signal8ApiClient({
baseUrl: 'https://api.signal8.ai/api/v1/public',
apiKey: 'sk_live_xxx',
});
const server = createMcpServer(client);
// Connect to any MCP transport...
License
MIT -- see the LICENSE file. Copyright (c) 2025-2026 Signal8 AI, Inc.
Use of the hosted Signal8 API and data is additionally governed by the Signal8
Terms of Service.
Signal8 Academy (free, no API key)
The free Signal8 Academy (plain-English guides to
dilution, SEC filings, market structure and using Signal8, plus a glossary) is
available to MCP clients without a Signal8 Pro API key: the local stdio
server answers these even when SIGNAL8_API_KEY is unset. (The hosted endpoint
still asks every tool call to sign in, as for any other tool.)
Kind
Name
What it returns
Tool
search_learn_guides
Guides matching a keyword query (optionally one track): title, description, URL
Tool
get_learn_guide
One guide (track + slug) as Markdown, with related guides and glossary terms
Tool
define_term
A glossary entry by slug, term or alias: short + long definition
Resource
signal8://learn
Index of every track, guide and glossary term
Resource
signal8://learn/guides/{track}/{slug}
A guide as Markdown
Resource
signal8://learn/glossary/{slug}
A glossary term as Markdown
Prompt
explain_dilution
Reads a company's dilution data (Pro tools) and explains each figure with the Academy guides
Tracks: dilution, filings, market-structure, signal8. Content is fetched
from GET /api/v1/public/learn/*, so guide updates appear without a package
release. Links in the Markdown point at signal8.ai.
S
Signal8
ai.signal8·425 yıldız·
SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Sorular
Signal8 nasıl kurulur?
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için http yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Signal8 için API anahtarı gerekiyor mu?
Yayıncı şu ortam değişkenlerini listeliyor: SIGNAL8_API_KEY.
Signal8 hangi aktarımı kullanıyor?
Signal8 sunucusuna HTTP üzerinden ulaşılır.
Signal8 en son ne zaman kontrol edildi?
Son kontrol: 2026-11-16. SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.