@signal8ai/mcp

MCP (Model Context Protocol) server for Signal8 -- AI-extracted SEC filing intelligence data.

Gives AI agents like Claude, Cursor, and other MCP-compatible tools direct access to:

• Company fundamentals (quotes, financials, earnings, float, executives, peers, news)
• Dilution risk scoring (0-100 Dilution Pressure Score with 5-dimension assessment)
• SEC filing extractions (warrants, convertibles, shelf registrations, and 10 more types)
• Instrument lifecycle tracking (warrants, convertibles, ATMs with XBRL reconciliation)
• Intelligence (counterparties, counsel, insiders, institutions, ROFR triggers, cluster buys)
• Cross-company intelligence (top AUM institutions, cross-company counsel & insider patterns)
• Compliance monitoring (Nasdaq/NYSE deficiency detection, listing classification)
• Company screening (dilution-aware filters with 30+ fields)
• ETF analysis (holdings, sectors, countries, performance, comparables)

Installation

npm install -g @signal8ai/mcp
# or use npx (no install needed)
npx @signal8ai/mcp

Setup

1. Get your API key

Sign up at signal8.com/settings/api-keys to get your API key.

2. Configure your MCP client

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "signal8": {
      "command": "npx",
      "args": ["-y", "@signal8ai/mcp"],
      "env": {
        "SIGNAL8_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "signal8": {
      "command": "npx",
      "args": ["-y", "@signal8ai/mcp"],
      "env": {
        "SIGNAL8_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Other MCP Clients

Set the SIGNAL8_API_KEY environment variable and run:

SIGNAL8_API_KEY=sk_live_your_key_here npx @signal8ai/mcp

Available Tools (49)

Companies (3 tools)

| Tool | Description | Credits | |------|-------------|---------| | search_companies | Search companies by name or ticker | 1 | | get_company_profile | Full company profile (description, market cap, sector) | 1 | | get_company_bundle | Consolidated data bundle in one call | 25 |

Company Data (13 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_quote | Real-time stock quote (price, change, volume) | 1 | | get_market_metrics | Volume averages, volatility, SMAs, trend direction | 3 | | get_short_interest | Short interest data and days-to-cover | 3 | | get_float | Float composition, shares outstanding, ownership % | 3 | | get_financials | Income statement, balance sheet, cash flow | 5 | | get_earnings | Earnings history with EPS surprises | 3 | | get_executives | Executive team roster and compensation | 1 | | get_peers | Peer/comparable companies | 1 | | get_transcripts | Earnings call transcripts | 3 | | get_news | Latest company news headlines | 1 | | get_analyst_consensus | Analyst ratings and price targets | 3 | | get_material_events | Material corporate events (8-K filings) | 3 | | get_clinical_trials | Clinical trial pipeline (biotech/pharma) | 3 |

Extractions (4 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_extractions | AI-extracted SEC filing data (13 types) | 5 | | get_filing_extractions | Extractions for a specific SEC filing | 5 | | get_extraction_dashboard | Cross-company extraction analytics | 50 | | get_extraction_by_type | Filter extractions by type (warrants, convertibles, etc.) | 5 |

Dilution (5 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_dilution_risk | Dilution Pressure Score (0-100) with 5-dimension assessment | 5 | | get_dilution_performance | Post-dilution stock performance at +1d/+7d/+30d/+90d | 10 | | get_instruments | Active warrants, convertibles, ATMs, shelf registrations | 5 | | get_instrument_detail | Deep dive on a single instrument | 5 | | get_baby_shelf | IB6 baby shelf remaining capacity | 10 |

Intelligence — Per-Company (12 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_counterparties | Entity-resolved counterparty relationships | 10 | | get_counsel | Legal counsel engagements with role taxonomy | 10 | | get_insiders | Insider trading discovery and patterns | 10 | | get_ownership | Unified ownership (Form 4 + 13F + 13D/G) | 10 | | get_rofr_triggers | ROFR exercise trigger detection | 10 | | get_institutions | Institutional holders from 13F filings | 10 | | get_institution_detail | Detailed info for a specific institution (by CIK) | 10 | | get_institution_holdings | Full portfolio holdings for an institution | 10 | | get_banks | Investment bank relationships from SEC filings | 10 | | get_legal_counsels | Legal counsel relationships with partner names | 10 | | get_insider_transactions | Detailed Form 4 transaction history | 5 | | get_insider_cluster_buys | Cluster buying pattern detection (3+ insiders in 14 days) | 10 |

Intelligence — Cross-Company (3 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_institution_top_aum | Top institutional holders by AUM across all companies | 25 | | get_counsel_cross_company | Law firm engagements across multiple companies | 25 | | get_insider_cross_company | Insider trading patterns across multiple companies | 25 |

Compliance (4 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_compliance | Full compliance evaluation | 25 | | get_deficiencies | Listing deficiency detection | 10 | | get_compliance_alerts | Active compliance alerts | 5 | | get_listing_classification | Exchange listing classification | 10 |

Screener (2 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_screener_fields | Discover available screening filters | 1 | | screen_companies | Dilution-aware company screener | 25 |

Events & ATM (2 tools)

| Tool | Description | Credits | |------|-------------|---------| | get_events | Unified corporate events | 5 | | get_atm_activity | ATM program monitoring | 5 |

ETF (1 tool)

| Tool | Description | Credits | |------|-------------|---------| | get_etf_bundle | Aggregated ETF data (profile, holdings, sectors, performance) | 25 |

Resources

| Resource | URI | Description | |----------|-----|-------------| | Company Profile | signal8://companies/{ticker}/profile | Enriched company profile by ticker | | Extraction Types | signal8://extraction-types | List of all 13 SEC filing extraction types |

Prompts (4)

| Prompt | Arguments | Description | |--------|-----------|-------------| | analyze_dilution_risk | ticker (string) | 6-step dilution risk analysis workflow | | company_due_diligence | ticker (string) | 10-step comprehensive due diligence research | | screening_workflow | sector?, marketCapMax? (string) | 5-step discover-screen-analyze workflow | | institutional_analysis | ticker (string) | 6-step institutional ownership & smart money analysis |

Hosted Endpoint

For web-based MCP clients, use the hosted Streamable HTTP endpoint:

POST https://mcp.signal8.com/mcp
Authorization: Bearer sk_live_your_key_here
Content-Type: application/json

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.com) |

Pricing

Each tool call consumes credits based on the endpoint it accesses. See credit costs in the tools table above. Get your free tier (100 credits/day) at signal8.com.

Programmatic Usage

import { createMcpServer, Signal8ApiClient } from '@signal8ai/mcp';

const client = new Signal8ApiClient({
  baseUrl: 'https://api.signal8.com',
  apiKey: 'sk_live_xxx',
});

const server = createMcpServer(client);
// Connect to any MCP transport...

License

MIT - see LICENSE