Tools & resources

Every tool is read-only and maps directly onto a REST API GET endpoint at https://api.quantconomy.com/api/v1. The MCP server is a thin proxy: a tool consumes the same credits and is subject to the same plan tier and rate-limit rules as calling that endpoint directly. SEC tools require a Starter plan or higher.

Note

List tools accept query (keyword; semantic on search_entries / list_prediction_markets), limit (1–100), and page. SEC list tools also accept sortBy. “Get” tools take a single id (record UUID). Only the tool-specific arguments are called out below.

News

Tool	REST endpoint	Arguments
search_entries	GET /entries	query (semantic by default), maxAgeHours, limit, after/before, topicSlug, publisherSlug, assetKey, sentimentScoreMin/Max, language, countryCode, publishedAfter/Before
get_entry	GET /entries/{id}	id
list_topics	GET /topics	query, limit, page
get_topic	GET /topics/{id}	id
list_publishers	GET /publishers	query, limit, page
list_clusters	GET /clusters	limit, page
get_cluster	GET /clusters/{id}	id

• search_entries — Search news entries. query is semantic-by-default (a natural-language query is embedded and matched by vector similarity, ranked by similarity; a UUID or a source:/publisher:/topic:/asset: prefix does an exact/keyword lookup). Semantic queries cost 2 credits. Without query, returns ML-enriched entries (sentiment, language) and supports cursor pagination plus topic/publisher/asset/sentiment/language/date filters.
• get_entry — A single news entry with metadata, related entries, topics, and signals.
• list_topics / get_topic — Economic topics/concepts.
• list_publishers — News publishers/sources.
• list_clusters / get_cluster — Entry clusters (trending story groups); the detail call returns related entries.

Markets

Tool	REST endpoint	Arguments
list_assets	GET /assets	query, limit, page, assetType, symbol
get_asset	GET /assets/{id}	id
list_markets	GET /markets	query, limit, page
get_market	GET /markets/{id}	id
get_market_candles	GET /markets/{id}/candles	id, limit, page, timeframe (e.g. "1h", "1d")
list_prediction_markets	GET /prediction-markets	query, limit, page
get_prediction_market	GET /prediction-markets/{id}	id

• list_assets — Financial assets (stocks, currencies, crypto, ETFs, etc.).
• get_asset — A single asset by id.
• list_markets / get_market — Trading-pair markets.
• get_market_candles — OHLCV candles for a market.
• list_prediction_markets / get_prediction_market — Prediction markets; the detail call returns outcomes/probabilities.

Signals

Oracle trading signals derived from news, insider trades, ownership, materiality, and more.

Tool	REST endpoint	Arguments
list_signals	GET /signals	limit, page, signalType, entityType, signalDirection, minStrength, assetId, includeExpired
get_signal	GET /signals/{id}	id
get_signals_by_entry	GET /signals/by-entry/{id}	id

• list_signals — Oracle trading signals with direction and strength.
• get_signal — A single signal by id.
• get_signals_by_entry — Signals generated from a specific news entry.

SEC

SEC datasets and analytics. Requires a Starter plan or higher. Each standard dataset has a list tool and a get-by-id tool.

Datasets

Tool	REST endpoint	Tool-specific arguments
sec_insider_trades	GET /sec/insider-trades	issuerCik, traderCik, formType, transactionType
sec_insider_trade	GET /sec/insider-trades/{id}	id
sec_financial_filings	GET /sec/financial-filings	—
sec_financial_filing	GET /sec/financial-filings/{id}	id
sec_beneficial_ownership	GET /sec/beneficial-ownership-filings	—
sec_beneficial_ownership_filing	GET /sec/beneficial-ownership-filings/{id}	id
sec_institutional_holdings	GET /sec/institutional-holding-filings	—
sec_institutional_holding_filing	GET /sec/institutional-holding-filings/{id}	id
sec_proposed_sales	GET /sec/proposed-sales	filerCik
sec_proposed_sale	GET /sec/proposed-sales/{id}	id
sec_filing_amendments	GET /sec/filing-amendments	—
sec_filing_amendment	GET /sec/filing-amendments/{id}	id
sec_current_report_items	GET /sec/current-report-items	itemNumber (e.g. "4.02"), category, isMaterialEvent, minMaterialityScore (0–1)
sec_current_report_item	GET /sec/current-report-items/{id}	id
sec_late_filing_notices	GET /sec/late-filing-notices	formType, reportType, issuerCik
sec_late_filing_notice	GET /sec/late-filing-notices/{id}	id
sec_proxy_statements	GET /sec/proxy-statements	formType, issuerCik
sec_proxy_statement	GET /sec/proxy-statements/{id}	id
sec_private_placements	GET /sec/private-placements	formType, issuerCik, industryGroup
sec_private_placement	GET /sec/private-placements/{id}	id
sec_tender_offers	GET /sec/tender-offers	formType, subjectCompanyCik
sec_tender_offer	GET /sec/tender-offers/{id}	id
sec_registration_statements	GET /sec/registration-statements	formType, issuerCik
sec_registration_statement	GET /sec/registration-statements/{id}	id
sec_filing_text_analyses	GET /sec/filing-text-analyses	sectionType, analysisStatus
sec_filing_text_analysis	GET /sec/filing-text-analyses/{id}	id

What each dataset covers:

• sec_insider_trades — Form 3/4/5 insider trades.
• sec_financial_filings — 10-K / 10-Q / 8-K / 20-F / 6-K financial filings.
• sec_beneficial_ownership — Schedule 13D/13G beneficial ownership filings.
• sec_institutional_holdings — Form 13F institutional holdings filings.
• sec_proposed_sales — Form 144 proposed insider sales.
• sec_filing_amendments — Filing amendments across all form types.
• sec_current_report_items — 8-K item-level rows with deterministic materiality scores; sort materialityScore:desc for the most material events. The detail call includes extracted item text and sentiment.
• sec_late_filing_notices — NT 10-K/10-Q/20-F late filing notices (restatement/distress signal).
• sec_proxy_statements — DEF 14A proxy statements.
• sec_private_placements — Form D private placements (Reg D exempt offerings).
• sec_tender_offers — Schedule TO / SC 14D9 tender offer filings.
• sec_registration_statements — S-1/F-1/S-3/424B registration statements (IPO pipeline).
• sec_filing_text_analyses — 10-K/10-Q NER + sentiment section analyses; the detail call returns full section text and entities.

Analytics

Derived endpoints that join and summarise the datasets above.

Tool	REST endpoint	Arguments
sec_proposed_sale_transitions	GET /sec/proposed-sales/transitions	filerCik, issuerCik, status, windowDaysBefore, windowDaysAfter, filingDateAfter, filingDateBefore, limit (1–2000)
sec_tender_offer_events	GET /sec/tender-offers/events	subjectCompanyCik, from, to, limit (1–1000)
sec_lockup_calendar	GET /sec/registration-statements/lockup-calendar	issuerCik, from, to, includePast, limit (1–1000)
sec_materiality_history	GET /sec/current-report-items/materiality-history	cik or tradingSymbol (one required), from, to, minScore (0–1), limit (1–2000)
sec_filing_section_diff	GET /sec/filing-text-analyses/{id}/diff	id

• sec_proposed_sale_transitions — Form 144 → Form 4 execution tracking: did proposed insider sales actually execute? Status EXECUTED_FULL / PARTIAL / NOT_EXECUTED / PENDING.
• sec_tender_offer_events — Tender offers grouped into events by target company (links SC TO and SC 14D9).
• sec_lockup_calendar — IPO lock-up expiration calendar (filingDate + lockupPeriodDays).
• sec_materiality_history — Per-company 8-K materiality timeline; requires cik or tradingSymbol.
• sec_filing_section_diff — Prior-period diff of a filing section (similarity, sentiment delta, newly-added sentences) versus the same filer’s previous filing.

Account

Tool	REST endpoint	Arguments
get_account	GET /account	—
get_usage	GET /account/usage	—
get_usage_timeseries	GET /account/usage/timeseries	days (1–365)
get_usage_endpoints	GET /account/usage/endpoints	days (1–365)
list_request_logs	GET /account/requests	limit, offset
list_api_keys	GET /account/api-keys	—
get_billing_history	GET /billing/history	limit, offset
list_credit_packages	GET /billing/packages	—
list_subscription_plans	GET /billing/plans	—
get_stats	GET /stats	—

• get_account — The authenticated account: plan, credit balance, and rate limits.
• get_usage / get_usage_timeseries / get_usage_endpoints — Usage summaries, daily usage charts, and per-endpoint credit/request totals.
• list_request_logs — Per-request history with status codes, credits charged, source, duration, and offset pagination metadata.
• list_api_keys — Key prefixes and metadata for the authenticated account; full key secrets are never returned.
• get_billing_history — Credit transaction history with offset pagination metadata.
• list_credit_packages / list_subscription_plans — Direct-platform credit top-up packages and subscription plan availability.
• get_stats — System-wide stats: entry/asset/market counts and last-update times.

Resources

Resources surface common context payloads at stable URIs, so an agent can attach them without invoking a tool. Each read proxies to the same REST endpoint.

Resource URI	Backing endpoint	Description
quantconomy://account	GET /account	The authenticated account (plan, credit balance, rate limits). Requires a valid API key.
quantconomy://stats	GET /stats	System-wide stats: entry/asset/market counts and last-update timestamps. Public.

Prompts

Prompts are parameterised research playbooks — pure templates that instruct the agent to chain the tools above. They make no API calls themselves; the agent runs the tools they reference.

market-brief

A concise market brief for an asset or topic: recent news sentiment, related signals, and notable SEC events.

Argument	Required	Description
query	yes	Asset symbol, company name, or topic to brief on (e.g. "AAPL", "lithium").
days	no	Look-back window in days for news/signals (default 7).

company-due-diligence

A structured SEC-filing due-diligence pass on a single company (insider activity, ownership changes, material events, registration/financing activity).

Argument	Required	Description
company	yes	Company name or ticker symbol.
cik	no	SEC CIK if known — lets the SEC tools filter precisely.

Related

Connect a client Configure Claude, Cursor, ChatGPT, and other MCP clients.

API reference Every underlying REST endpoint, with schemas and examples.