mcpField
C
Canli Markets

Canli Markets

Local
canlicapital.comFinance5Updated 3d ago

About Canli Markets

Canli Markets is an MCP server that gives AI agents access to market and company research from public financial sources. It combines filings, rates, prices, prediction markets, DeFi data, and analytical tools, with source URLs and evidence to support checking results.

Key features

  1. 01Search and analyze SEC filings
  2. 02Read European ESEF reports
  3. 03Compare and screen companies
  4. 04Retrieve rates and market prices
  5. 05Query prediction markets and DeFi data
  6. 06Attach source links and evidence

Use cases

  1. 01Compare company financials and valuation
  2. 02Check figures in a draft against filings
  3. 03Track central-bank rates and market odds
  4. 04Review crypto protocol fees and value locked

MCP support

Exposes financial research and market-data operations as tools for MCP clients, including SEC and ESEF filings, rates, prices, prediction markets, and DeFi data. Results include source URLs, and evidence records can include document hashes and retrieval times.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"arhancanli-canli-markets": {
"command": "npx",
"args": [
"-y",
"canli-markets-mcp"
],
"env": {
"SEC_USER_AGENT": "<SEC_USER_AGENT>",
"ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
"ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
"TIINGO_API_KEY": "<TIINGO_API_KEY>"
}
}
}
}
Run commandnpx -y canli-markets-mcp
Environment variables to set
SEC_USER_AGENTYour name and email for SEC's fair-access policy, e.g. "Jane Doe [email protected]" (optional).
ALPACA_API_KEY_IDSecretAlpaca key id for price_history (optional; paper keys work).
ALPACA_API_SECRET_KEYSecretAlpaca secret for price_history (optional).
TIINGO_API_KEYSecretTiingo key for price_history if you do not use Alpaca (optional).

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmcanli-markets-mcp0.7.4

Tools

34

Saved tool list · updated 3d ago

ParameterTypeRequiredDescription
limitintegerNoMost companies to return; default 25.
orderenumNodesc | asc
periodstringNoFY2025 (each company's fiscal year that best overlaps calendar 2025; default the last complete year) or a quarter such as CY2026Q2.
columnsarrayNoExtra metrics to show.
filtersarrayNoConditions every company must meet.
sort_bystringNoMetric to rank by; default the first filter's metric, else revenue.
exchangesarrayNoListing venues to include; default NYSE and Nasdaq. "all" includes unlisted filers.
valuationbooleanNoAdd price, market cap, P/E, P/S and FCF yield for the returned companies (latest close; up to 50 companies).
include_suspectbooleanNoKeep companies whose figures fail a plausibility check (for example net income above 10 times revenue, usually a tagging slip); default false: they are listed apart.

Details

From the project README

canli-markets-mcp

Public market data for AI agents, read from the sources themselves: SEC EDGAR, the US Treasury, FRED, the World Bank, the New York Fed, the ECB, the Bank of England and the BIS, European companies' ESEF reports, prediction markets, DeFi data and prices for stocks, currencies, futures, indices and crypto, with no key and no account. Every request goes from your machine straight to the source, and every result names the URL it came from, so an agent can cite it.

{ "mcpServers": { "canli-markets": { "command": "npx", "args": ["-y", "canli-markets-mcp"] } } }

Set SEC_USER_AGENT to your name and email ("Jane Doe [email protected]"), as SEC's fair-access policy asks. Prices need no key: they come from Yahoo Finance's public chart data, which is unofficial and for personal use under Yahoo's terms. To use your own account instead, set ALPACA_API_KEY_ID and ALPACA_API_SECRET_KEY (paper keys work) or TIINGO_API_KEY; CANLI_KEYLESS_PRICES=0 turns the keyless source off.

Research across the whole market

Other finance servers answer one company at a time. These answer questions about the market:

ToolWhat it answersSource
screen_companiesRank every US-listed company (about 3,800 with FY2025 data) on revenue, growth, margins, ROE, ROA, free cash flow, R&D intensity or leverage, with filters and valuation for the shortlistSEC XBRL frames, prices
company_reportEverything about one company in one call: five years of financials, valuation, a year of price and risk, insider buying and selling, recent filingsSEC, prices
event_studyHow the stock reacted to earnings releases, insider purchases or sales, or any dates: abnormal returns against a market model, with a t test across eventsSEC filing times, prices
mentions_trendHow often filings mention a phrase, by month, quarter or yearEDGAR full-text search

Examples: "Which large companies grew revenue fastest in 2025, and what do they trade at?", "Rank companies over $50 billion of revenue by R&D intensity", "Does NVIDIA's stock rise after its earnings releases?", "How fast are filings adopting the phrase 'agentic AI'?".

Figures no real company reports (one 2026 filing tagged $1.157 billion of net income as $1,157 billion) are held out of rankings and listed apart, with the reason.

Every result also carries evidence: the documents read, with the SHA-256 of the exact bytes received and when, so any figure can be checked against the same document later.

An analyst's filings

ToolWhat it answersSource
financial_statementsThe income statement, balance sheet, cash flow and equity statement exactly as filed, several years joined; what a later filing restated, and what a split changed, beside the first-reported figure10-K/10-Q rendered XBRL reports
filing_tablesThe table that holds a figure, by words, in one filing or followed through several (members, stores, ARPU, segment and region detail, non-GAAP reconciliations, guidance tables)10-K/10-Q/8-K documents and XBRL reports
earnings_releaseA results press release: the results, the guidance as ranges, and last quarter's guidance against this quarter's results8-K Item 2.02, exhibit 99
verify_claimsIs a figure in a draft answer right? Confirmed, contradicted (with the filed figure and what the wrong one matches: last year, a quarter, a unit slip, the wrong currency), or not reported (a future year, a dividend a company never paid); US and foreign filers (20-F, IFRS) in the currency they report inXBRL company facts

Examples: "Show Microsoft's last four years of income statements as filed", "How has Costco's paid membership grown over five years?", "Did NVIDIA beat its revenue guidance last quarter, and what is it guiding to now?", "What full-year EPS range is Walmart guiding to, and how has it moved since the original guide?", "Check this paragraph's numbers before I send it."

Beyond the US

ToolWhat it answersSource
european_filingsA European company's annual report as it tagged it: revenue, operating and net profit, EPS, assets, equity, cash, cash flows and dividends with the comparatives, in its own currency at full scale; any other tagged figure by words; the other years on fileESEF reports (filings.xbrl.org)
reference_ratesSOFR, TGCR, BGCR, EFFR and OBFR (with percentiles and volume), the euro short-term rate and the ECB's policy rates (the rate in effect and its changes), SONIA and Bank Rate, and about forty central banks' policy ratesNew York Fed, ECB, Bank of England, BIS
prediction_marketsWhat traders pay for an outcome (a Fed decision, a recession, an election), as a probability with bid, ask, volume and closing date, from both venuesPolymarket, Kalshi
crypto_fundamentalsA DeFi protocol's value locked (by chain, with history), the fees users pay it and the revenue it keeps; a chain's value locked; a stablecoin's supply and its changeDefiLlama

Examples: "What did ASML report for 2025 revenue and net profit?", "Where is SOFR against the fed funds range this month?", "When did the ECB last change its deposit rate?", "What odds do prediction markets give a US recession this year?", "How much revenue does Aave keep from its fees?". bench/global/crosscheck.mjs sets these tools against sources they do not read: ESEF figures against the same companies' Form 20-F at the SEC, and the central banks' policy rates against the BIS (21 of 21 agreed on 2026-10-15).

Tools

ToolWhat it answersSource
company_profileWho is this company or fund: tickers, industry, fiscal year, latest 10-K/10-Q/8-K/13FSEC
list_filingsWhat has it filed: by form and date, with linksSEC
read_filingWhat does the filing say: one 10-K/10-Q item ("risk factors", "md&a"), an 8-K press release (EX-99.1), pagedSEC
search_filingsWhich filings mention a phrase, since 2001EDGAR full-text search
company_eventsA company's news from its 8-Ks (earnings, deals, executive changes, restatements, bankruptcies, cyber incidents): the headline of the press release attached, and the filing's own words; or one kind of event across the marketForm 8-K
latest_filingsWhat has just been filed, across every company: newest first by acceptance time, by form (8-K, 10-K, 4, SC 13D, S-1), 8-K event and filer name; the last few business daysEDGAR latest-filings feed
filing_diffWhat changed in a 10-K (or 10-Q) against the one before, section by section: new and dropped paragraphs, the sentences changed in the rest, and the words whose use rose or fell most (Apple 2025: court, remedies, enforcement from 0 to 4 or 5)SEC EDGAR filings
newsNews about a company or a topic from the world's press: articles newest first with outlet and country, and the daily average tone of the coverageGDELT Project (open index, no key)
explain_moveWhy a stock moved on a day: its return against the market and how rare it was for the stock (z-score from a one-year market model), the SEC filings around the day and the press's headlines (NVIDIA 2026-08-27: +7.6% abnormal, z 4.3, its earnings 8-K the evening before)Price provider, SEC EDGAR, GDELT
portfolio_xrayA portfolio seen through its funds: each ETF or fund opened into its latest N-PORT positions and added to the stocks held directly, for the real exposure to each company, the overlap between funds and the effective number of positionsSEC Form N-PORT
compsA comparable-companies table: the company beside its listed peers under the same SEC industry code, the nearest in revenue, on growth, margins, ROE, R&D intensity and FCF margin, with the peers' median and the company's rank on eachSEC XBRL frames and EDGAR's company list by SIC
debt_profileA company's debt from its annual reports: total and net debt, the maturity ladder from its debt note, lease payments, interest expense, implied rate, coverage and debt to EBITDA, with five years of debt and cash (AT&T 2025: $134.7 billion, 5.3% implied, covered 3.6 times)SEC XBRL company facts
ownership_breadthHow many institutions hold a stock, quarter by quarter: 13F filers whose holdings tables list its CUSIP, the change, and a sample of holders (Apple, Q2 2026: 6,776, up 1.9% on the quarter)EDGAR full-text search over 13F information tables
forensic_scoresBeneish's M-score, Piotroski's F-score and Altman's Z-score in one call, every input read from the company's annual XBRL with its tag, and missing inputs named rather than guessedSEC XBRL company facts, price at the fiscal year end
funding_ratesCrypto perpetual funding: each coin's latest eight-hour rate, the window's mean and annualized carry, the last week's, and the share of positive periods (BTC, 90 days to 2026-10-24: 5.6% a year)OKX public data (no key)
compute_pricesCompute as a market: the on-demand hourly price of each data-centre GPU across the clouds (cheapest, median and dearest, and who offers them), every provider's offer for one model, recent list-price changes, and the Cirrun GPU Index (H100 SXM, 2026-10-24: $1.99 to $12.29 an hour, median $3.95)Cirrun's GPU price index (no key, CC BY 4.0)
federal_contractsWhat the US government obligated to a company in a fiscal year: the total, by agency and industry code, the entities it contracts under, and its largest contracts with links (Lockheed Martin, fiscal 2026: $53.2 billion from Defense)USAspending.gov (no key)
drug_pipelineA drug company's active clinical trials by phase, the primary completions due in the coming months (the next readouts), its late-stage trials and its FDA approvals (Vertex: 31 active trials, 16 in phase 3)ClinicalTrials.gov and Drugs@FDA (no key)
comment_lettersWhat the SEC's staff questioned in a company's filings and how it answered, grouped into reviews, with the topics of the newest letters (Apple, 2024: revenue recognition, segments, MD&A)SEC EDGAR forms UPLOAD and CORRESP
shareholder_returnsWhat a company has paid its owners each year: dividends per share (with its split-adjusted record: years raised in a row, 5- and 10-year growth) and in total, buybacks and shares issued, the diluted share count, the payout ratio and the share of free cash flow paid out, and the dividend and shareholder yields at the last closeSEC XBRL company facts, the last close
reverse_dcfThe free-cash-flow growth a share price implies: a DCF solved for the growth that reaches the market's enterprise value, every input from the annual XBRL with its tag, a sensitivity table and the company's own growth beside itSEC XBRL company facts, the last close
filing_driftHow a 10-K section's language drifts over several years: each year's change from the last (the measure Cohen, Malloy and Nguyen's "Lazy Prices" found preceded weaker returns), hedging and adverse words, readability, and a theme you name, with flags (Nvidia's risk factors: export-control sentences 8, 14, 37, 48, 51 over five reports)SEC 10-K filings, computed on your machine
bank_financialsA US bank's condition quarter by quarter from its call reports: assets, deposits and the share uninsured, loans and the share noncurrent, earnings, margin, returns and capital ratios; with no bank, the latest failures and their cost (Western Alliance, June 2026: 38% of deposits uninsured, tier 1 leverage 8.1%)FDIC BankFind (no key)
earnings_calendarA company's results release dates with the quarter covered and before the open or after the close, and the next one estimated from the same quarter last year; or who is due to report in a window across the marketSEC EDGAR (8-K Item 2.02)
segment_revenueWhere revenue comes from: by segment (with operating income), product and region, three years, checked against total revenue10-K/10-Q XBRL
insider_tradesWho inside bought or sold, at what price, under a 10b5-1 plan or notForm 4
planned_insider_salesInsiders' planned sales from Form 144, filed before they sell: seller, role, shares, value, approximate sale date, how the shares were acquired, any 10b5-1 plan date, and totals by sellerForm 144
fund_holdingsWhat a fund manager holds, its weights, and what it bought and sold last quarter13F
investment_advisersWho an investment adviser is: registration, offices, other names, disclosure flags, Form ADV and brochuresSEC Form ADV (IAPD)
large_holdersWho owns more than 5 percent, passive (13G) or activist (13D, with its stated purpose); or the week's new activist stakes across the marketSchedules 13D and 13G
private_offeringsWho is raising private money (startups, private equity, hedge and real estate funds): amount sold, investors, exemption, peopleForm D
ipo_pipelineCompanies that filed or amended a registration (S-1, F-1) in a window, labelled IPO candidate, SPAC, fund or already listed, and offerings priced (424B4) with price, shares and proceeds from the coverEDGAR full-text search
fails_to_deliverShares that failed to settle for a stock over the last month, or the largest fails across the marketSEC fails-to-deliver data
off_exchange_volumeHow much of a stock trades in dark pools and with other off-exchange dealers each week, and whereFINRA OTC transparency
short_interestHow heavily a stock is shorted (shares short, days to cover, share of shares outstanding), or the market's most shortedFINRA
futures_positioningWho is long and short in a futures market (managed money, dealers, asset managers, leveraged funds) and how crowdedCFTC Commitments of Traders
executive_payWhat executives are paid against how the company did (reported and actually-paid pay, TSR vs peers), five years; or CEO pay ranked across the marketProxy pay-versus-performance XBRL
index_constituentsThe members of the S&P 500, Nasdaq 100, Russell 2000 and other indexes, with weightsN-PORT of a tracking ETF
fund_portfolioWhat a mutual fund or ETF holds (VOO, IVV, AGG): every position, exposures, a bond fund's coupon and maturity, monthly returns and money in and outForm N-PORT
economic_calendarWhen the data comes out: BLS, BEA, Census and FOMC release dates and times, the market-moving ones flaggedThe agencies' own schedules
fomcThe Fed's decisions for a year (action, target range, vote and dissenters), the latest statement and the dot-plot mediansFederal Reserve
treasury_yieldsThe Treasury curve (nominal, real, bills) for a day or a rangeUS Treasury
economic_seriesAny FRED series by id or words ("core inflation"), as levels, changes or year-over-yearFRED
options_chainAn option chain with IV, greeks, open interest, put/call ratios, max pain and the expected moveCboe delayed quotes
volatility_surfaceImplied volatility term structure, 25-delta skew and the smileCboe delayed quotes
futures_curveThe VIX futures curve (and other Cboe futures) against the index: contango or backwardationCboe settlements
market_overviewThe market at a glance: US indices and the VIX, the eleven sectors ranked by the month, Treasury yields, the dollar and major currencies, oil, gas, gold, silver, copper, bitcoin, ether and the main markets abroad, each over a day, a week, a month, three months, the year to date and a yearYahoo Finance chart data (no key)
price_historyDaily to monthly bars for stocks in the US and abroad, currencies, futures, indices and crypto, adjusted, with dividends and splits, as columnsYahoo Finance (no key), or Alpaca or Tiingo (your key) for US stocks
treasury_auctionsHow each Treasury auction went (yield, bid-to-cover, who bought) and which auctions come nextUS Treasury Fiscal Data
federal_debtThe US debt each business day, and the average rate the Treasury pays on itUS Treasury Fiscal Data
economic_outlookThe OECD's projections for the next two years: growth, inflation, unemployment, deficits, debt, current account, ratesOECD Economic Outlook
world_economyAny country's economy: GDP and growth, inflation, unemployment, debt, deficits, trade, reserves, for 200+ countries and regionsWorld Bank (CC BY 4.0)

Examples an agent can now answer in one or two calls: "What are the new risk factors in Nvidia's latest 10-K?", "Did any Tesla insider buy shares on the open market this year?", "What did Berkshire Hathaway sell last quarter?", "Where is the 2s10s spread today?", "What is core PCE inflation year over year?".

Results are columns and rows, so a series feeds straight into analysis: with canli-mcp, economic_series or price_history output goes into any of its 235 quant tools in the same batch.

Checked against the source

The tests replay real SEC, Treasury and FRED responses and check values read off the documents: Berkshire Hathaway's 13F for the quarter ending 30 June 2026 totals $299,253,556,246 over 89 entries, exactly the figures on its cover page; Apple's 10-K risk factors come back as Item 1A alone; a Tesla Form 4 sale reads 2,605.75 shares at $360.134.

Limits

  • Filings are shown as filed; nothing is edited or verified.
  • Form 4 is due two business days after a trade; Form 5 filings are not read.
  • A 13F lists long US-listed equity and option positions at quarter end, filed up to 45 days later; it omits shorts, cash and confidential positions. Amendments are not merged.
  • FRED revises recent values of many series; some series are copyrighted by their sources.
  • Keyless prices are Yahoo Finance's unofficial chart data, for personal use; they can change or stop without notice. Alpaca's free IEX feed reports IEX volume only.
  • Not investment advice.

See SECURITY.md for exactly what is sent where.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.