Twelve Data

Read live and historical prices, indicators and fundamentals.

Add to Agentman Studio

Opens Agent Studio, where connecting is one click. The connector URL below works in any MCP client.

Paste it into any MCP client. Setup docs

Resources

What the Twelve Data connector does

The Twelve Data MCP server connects a financial market data platform — real-time and historical prices, technical indicators and company fundamentals — to Claude, ChatGPT and any MCP-compatible agent. All 27 tools read; none writes. Twelve Data publishes the server's source code, so the tool list on this page is counted from the implementation rather than taken on trust.

Verified connector

Listed by Anthropic as a partner connector in its Connectors Directory.

Connection checked by Agentman on .

Anthropic states this reflects the level of review a connector received, not a security audit.

Twelve Data tools (27)

  • auth_status
  • currency_conversion
  • get_analyst_data
  • get_api_usage
  • get_company_info
  • get_company_news
  • get_dividends
  • get_earliest_timestamp
  • get_earnings
  • get_etf_data
  • get_financials
  • get_ipo_calendar
  • get_market_cap
  • get_market_movers
  • get_market_state
  • get_mutual_fund_data
  • get_price
  • get_quote
  • get_reference_data
  • get_regulatory_data
  • get_splits
  • get_statistics
  • get_technical_indicator
  • get_time_series
  • oauth_configure
  • oauth_login
  • search_symbol

Tool names from Anthropic's directory listing. This server requires sign-in, so we could not read tool descriptions or parameter schemas.

Limits

  • The hosted endpoint was unreachable on 2026-08-23. Every path we probed on mcp.twelvedata.com — the MCP endpoint, the four RFC 9728 and OAuth metadata paths, the site root, a deliberately nonexistent control path, and the server's own /health route — returned Cloudflare error 521 with byte-identical 16-byte bodies. 521 means Cloudflare reached the edge but the origin refused the connection. DNS resolved normally to Cloudflare addresses. This is an origin outage, not a blocked client and not a catch-all responder.
  • We therefore could not verify the auth posture live. authVerified is false. OAuth is documented by Twelve Data and implemented in the published source — the server acts as its own OAuth 2.1 authorization server with dynamic client registration, delegating login to Twelve Data — but we did not observe an authentication challenge over the wire, and we do not launder a vendor claim into our own observation.
  • We could not confirm the hosted server runs the published commit. The 27-tool match is between Anthropic's directory and the open-source repository at fa3e9c2. A deployment could differ from its repository, and the outage removed the handshake that would have settled it.
  • The single OAuth scope bounds nothing. The source defines one scope, twelvedata, described as meaning access on the user's behalf. It names neither a verb nor an object, and reading the tool-call path shows no tool consults it. Advertised scopes are not enforced scopes; here there is nothing to enforce. Because every tool is a read against a read-only API, the practical cost of that is low — but no boundary exists between a cheap reference lookup and an expensive premium dataset call.
  • Six tools forward an unrecognised argument as an API path. The reachable surface is 187 documented paths, not 27 tools. The mitigating fact is that 186 of those are GET. get_reference_data is the only dispatcher that rejects an unknown value.
  • Data licensing is restrictive and exchange rules pass through. Internal Use only unless a tier or add-on says otherwise; no redistribution; no commercial use of free-tier data; no derivative financial products without written permission; caching limited to documented timeframes. Exchange fees, professional subscriber rates and audit obligations are the customer's responsibility, and providers hold enforcement rights.
  • Free and Basic plans cap at 800 requests per day in addition to the per-minute credit limit, and their WebSocket credits are trial-only against a restricted symbol set.
  • Indices, options and bonds are not searchable through search_symbol. The tool's own docstring states this and suggests an ETF proxy for an index instead.
  • A local-session fallback exists in the source. When exactly one user token is persisted and no session identifier matches, _token_from_ctx returns that user's token. That is a convenience for single-user local deployments; on a shared deployment it is a design worth understanding before self-hosting multi-tenant.
  • The repository carries no licence file. Twelve Data describes the server as open-source and publishes the code, but GitHub reports no licence for it. That constrains reuse of the code, separately from the data licensing above.
  • Nothing here is investment advice. The connector returns prices, filings and published analyst estimates as data. Twelve Data disclaims warranty on third-party data and its terms prohibit using the platform for market manipulation or fraudulent trading.

Frequently asked questions

Does the Twelve Data connector spend money when an agent calls a tool?

Not directly. Twelve Data credits are a per-minute throughput limit, not a prepaid balance that drains, so a call consumes rate rather than money. Exhausting the limit returns HTTP 429, not a charge. One exception matters: Twelve Data's terms state that for usage-based pricing, overage charges apply for exceeding subscription limits.

Can an agent check the Twelve Data credit balance before spending it?

Yes. The get_api_usage tool calls the api_usage endpoint and returns current_usage, plan_limit and plan_category. That closes the gap common to metered connectors, where an agent can spend quota with no tool that reads it. The reading itself costs one credit, and the plan limit is per minute rather than a running total.

How many tools does the Twelve Data MCP server have?

Twenty-seven, and unusually for this catalogue that number is checkable. Twelve Data publishes the server source at github.com/twelvedata/mcp. Counting the decorated tool functions at commit fa3e9c2 gives 27 names that match Anthropic's directory listing exactly, with no name on either side that the other lacks.

Can the Twelve Data connector place a trade or move money?

No. Twelve Data is a market data vendor, not a broker. Its OpenAPI specification describes 187 paths, of which 186 are GET and the single POST submits a batch of read queries. No tool in the connector writes to an account, and the underlying API exposes no order, transfer or payment operation to write to.

What OAuth permissions does the Twelve Data MCP server request?

One scope named twelvedata, which names no verb and no object. The source defines it as a single scope meaning access on the user's behalf. Reading the tool-call path at commit fa3e9c2 shows no tool checks it, so the scope records that a login happened rather than bounding what the session can read.

Can I redistribute Twelve Data results an agent retrieves?

Generally no without a specific add-on. Twelve Data's terms grant a licence for Internal Use and restrict redistribution, resale and sublicensing except where a Subscription Tier, Redistribution Rights Add-On or separate agreement permits it. Individual plans are limited to personal internal use; external display requires a Business plan.

Do stock exchange rules apply to data pulled through the connector?

Yes, and they flow through to you directly. Twelve Data's terms state that access to Third-Party Data may require executing agreements with the providers, complying with exchange rules and reporting requirements, and paying exchange fees or professional subscriber rates. Third-Party Providers are named as third-party beneficiaries with enforcement rights.

Why did connecting to the Twelve Data MCP server fail?

The hosted endpoint may be down. On 2026-08-23 every path on mcp.twelvedata.com, including the server's own health route, returned Cloudflare error 521 — origin unreachable — with byte-identical bodies. Twelve Data publishes a status page at twelvedata.isitup.cloud. Running the server locally with an API key is the documented alternative.

Sources

More Finance connectors

  • Affinity

    Search your CRM, prep for meetings and update deal records from your AI assistant.

  • Aiera

    Pull earnings-call transcripts, event calendars, SEC filings and company publications into your AI assistant.

  • Airwallex Developer

    Search Airwallex documentation and exercise a sandbox account from an AI agent.

Browse all MCP connectorsClaude and ChatGPT setup guideBrowse AI skills

Product names and logos belong to their owners. Agentman is not affiliated with a connector's maker unless the page says the connector is built and run by Agentman.

Use it in an agent

Put Twelve Data to work.

Connect Twelve Data once and your agents call these tools on their own: on a schedule, in a workflow, with nobody at the keyboard.

Open in Agentman Studio
Call (650) 285-1019Our AI receptionist answers.