API and MCP
Documentation
Retrieval-only public 8-K statistics for Muse. No API key. HTTPS GET. Not a broker. Not investment advice.
Endpoints
- REST base: https://secstocksignals.agentstructure.ai/api/v1
- Health: https://secstocksignals.agentstructure.ai/api/v1/health
- OpenAPI: https://secstocksignals.agentstructure.ai/api/v1/openapi.json
- MCP: POST https://secstocksignals.agentstructure.ai/mcp
- Reviewer script: https://secstocksignals.agentstructure.ai/review
Tools
- list_capabilities
- GET https://secstocksignals.agentstructure.ai/api/v1/capabilities
- What SEC Stock Signals will and will not do. Call this first.
- get_health
- GET https://secstocksignals.agentstructure.ai/api/v1/health
- Reviewer ping. Confirms research files loaded and that ticker lookup is not pending.
- get_study_verdict
- GET https://secstocksignals.agentstructure.ai/api/v1/verdict
- Overall empirical conclusion of the 2016–2024 development / 2025 holdout 8-K study. Not investment advice.
- get_integrity
- GET https://secstocksignals.agentstructure.ai/api/v1/integrity
- Clock, leakage, HTML-price, duplicate, and predecessor-CIK regression tests.
- get_event_family
- GET https://secstocksignals.agentstructure.ai/api/v1/families
- Development-sample 20-session SPY-adjusted returns for one 8-K event type, e.g. nonreliance_financials.
- lookup_ticker_events
- GET https://secstocksignals.agentstructure.ai/api/v1/ticker/{ticker}
- Look up any SEC company by ticker. Study names include historical returns. Every other EDGAR company returns live 8-Ks and Form 4 counts. Not a trade signal.
- scan_watchlist
- GET https://secstocksignals.agentstructure.ai/api/v1/watchlist
- Scan a user-named ticker list for recent 8-Ks (live SEC) and Form 4 counts. Muse must pass the tickers. Does not read a brokerage. Not a trade signal.
- get_ledger
- GET https://secstocksignals.agentstructure.ai/api/v1/ledger
- Public officer-change ledger. Each row is the frozen 2016–2024 base rate plus the later 20-session SPY-adjusted return. Misses stay. Not a trade.
- search_companies
- GET https://secstocksignals.agentstructure.ai/api/v1/companies
- Find SEC companies by ticker or name. Example: QNTM or Quantum Biopharma.
- material_since
- GET https://secstocksignals.agentstructure.ai/api/v1/material-since
- Free. Real 8-K and Form 4 filings since an ISO time. Echoes every ticker. Does not invent filings.
- form4_cluster
- GET https://secstocksignals.agentstructure.ai/api/v1/form4-cluster
- Premium ($9/month) tool, not open yet; waitlist. No clusters until entitlement exists.
- anomaly_rank
- GET https://secstocksignals.agentstructure.ai/api/v1/anomaly-rank
- Premium ($9/month) tool, not open yet; waitlist. No ranks until entitlement exists.
Watchlist
The user names tickers once. Muse remembers them and calls:
GET https://secstocksignals.agentstructure.ai/api/v1/watchlist?tickers=NVDA,AAPL,MSFT&days=30
Live SEC 8-Ks and Form 4 counts. We do not read a brokerage and we do not store a user account.
Auth
None. No OAuth, no API key, no user secrets. CORS allows GET from any origin so Muse can call the tools.
MCP for ChatGPT
Remote MCP at https://secstocksignals.agentstructure.ai/mcp. Transport: Streamable HTTP, JSON-RPC 2.0, protocol 2025-06-18. Same business logic as the REST tools. Publisher: AgentStructure.AI.
- In ChatGPT, open Settings → Connectors → add a remote MCP server.
- URL: https://secstocksignals.agentstructure.ai/mcp
- No OAuth for public study tools. Do not put keys in the URL.
- Ask: “Scan NVDA and AAPL for recent 8-Ks.”
MCP Inspector: npx @modelcontextprotocol/inspector then connect to https://secstocksignals.agentstructure.ai/mcp with Streamable HTTP.
Errors
- 400 tickers_required — watchlist called with no names
- 404 unknown_ticker — name not in the study universe
- Do not invent filings for unknown names