MCP server for S&P Capital IQ data via kFinance. Exposes 31 tools covering company intelligence, financials, market data, estimates, earnings transcripts, M&A, business relationships, and funding data.
- Python 3.10+
- S&P Global LLM-ready API subscription
kensho-kfinancelibrary
pip install -e .
cp ciq_mcp.example.toml ciq_mcp.toml
# then edit ciq_mcp.toml with your Kensho credentialsCIQ MCP requires Kensho OAuth authentication. Three methods supported:
python -m ciq_mcp
# Opens browser for login on first runexport CIQ_MCP_AUTH_METHOD=keypair
export CIQ_MCP_AUTH_KEYPAIR_ID=your-id
export CIQ_MCP_AUTH_KEYPAIR_SECRET=your-secret
python -m ciq_mcpexport CIQ_MCP_AUTH_METHOD=refresh_token
export CIQ_MCP_AUTH_REFRESH_TOKEN=your-token
python -m ciq_mcppython -m ciq_mcpexport CIQ_MCP_API_KEY=your-secret-key
python -m ciq_mcp --http --port=8080python -m ciq_mcp --sse --port=8080docker build -t ciq-mcp .
docker run -p 8080:8080 -e CIQ_MCP_API_KEY=secret -e CIQ_MCP_AUTH_METHOD=keypair \
-e CIQ_MCP_AUTH_KEYPAIR_ID=id -e CIQ_MCP_AUTH_KEYPAIR_SECRET=secret ciq-mcpciq_company_info— Name, status, type, industry, employees, HQciq_company_summary— One-paragraph summaryciq_company_description— Detailed multi-section descriptionciq_company_names— Alternate, historical, native namesciq_competitors— Competitor identification by source
ciq_prices— Historical OHLCV pricesciq_capitalization— Market cap, TEV, shares outstandingciq_history_metadata— Exchange, currency, first trade date
ciq_financial_statement— Balance sheet, income statement, cashflowciq_financial_line_item— Specific line items with time periodsciq_segments— Business and geographic segments
ciq_consensus_estimates— EPS, Revenue, EBITDA consensusciq_target_price— Analyst target pricesciq_guidance— Company-issued guidanceciq_analyst_recommendations— Buy/hold/sell breakdown
ciq_earnings— All earnings callsciq_latest_earnings— Most recent earningsciq_next_earnings— Next scheduled earningsciq_transcript— Full earnings call transcript
ciq_mergers— All M&A transactionsciq_merger_info— Transaction detailsciq_advisors— Advisory firms
ciq_business_relationship— Suppliers, customers, partners, etc.
ciq_funding_summary— Total capital raisedciq_funding_rounds— Round overviewsciq_funding_round_info— Detailed round data
ciq_get_latest— Current reporting datesciq_n_quarters_ago— Historical quarter lookupciq_cusip— CUSIP identifiersciq_isin— ISIN identifiersciq_metrics— Server metrics and health
Edit ciq_mcp.toml or use environment variables (CIQ_MCP_*):
[auth]
method = "keypair"
[cache]
maxsize = 2000
ttl_prices = 30
ttl_company_info = 86400
[api]
timeout = 30.0
max_per_minute = 60Apache 2.0