Twelve Data
by Twelve Data
Read real-time and historical market prices, technical indicators and company fundamentals from an AI agent. Twelve Data publishes the server's source, and its 27 tool names match Anthropic's listing exactly. Every tool is read-only; six forward a caller-supplied string as an API path.
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.
Connect Twelve Data via MCP
https://mcp.twelvedata.com/mcpWorks in any MCP-compatible client. In Agentman Studio it is one click — no config file to edit.
Twelve Data Tools & Capabilities (27)
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/healthroute — 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.
authVerifiedisfalse. 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_datais 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_ctxreturns 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
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.
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.
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.
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.
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.
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.
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.
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
- Twelve Data MCP server source code (read at commit
fa3e9c28e41c292435d7ec0360ddda835addd91b, pushed 2026-07-23; retrieved 2026-08-23). Tool enumeration, annotations, dispatcher fallthrough, scope definition and session handling all read from this source. · retrieved 2026-07-23 - Twelve Data MCP server documentation (retrieved 2026-08-23) · retrieved 2026-08-23
- Twelve Data machine-readable documentation index, llms.txt (retrieved 2026-08-23) · retrieved 2026-08-23
- Twelve Data OpenAPI specification (retrieved 2026-08-23). 187 paths; 186 GET, 1 POST. · retrieved 2026-08-23
- Twelve Data API usage endpoint documentation (retrieved 2026-08-23) · retrieved 2026-08-23
- Twelve Data introduction, error codes and rate limits (retrieved 2026-08-23) · retrieved 2026-08-23
- Twelve Data pricing, machine-readable (retrieved 2026-08-23). Credit definition, plan tiers, Individual versus Business boundary. · retrieved 2026-08-23
- Twelve Data Terms of Service (retrieved 2026-08-23). Licence grant, restrictions, third-party data and exchange requirements, usage-based fees. · retrieved 2026-08-23
- Twelve Data privacy policy (retrieved 2026-08-23) · retrieved 2026-08-23
- Twelve Data system status (retrieved 2026-08-23) · retrieved 2026-08-23
- Live endpoint probe,
https://mcp.twelvedata.com/mcpand six sibling paths including/healthand the RFC 9728 metadata routes — all HTTP 521, byte-identical bodies (2026-08-23) · retrieved 2026-08-23 - Twelve Data
robots.txt(retrieved 2026-08-23). CarriesContent-Signal: search=yes, ai-input=yes, ai-train=no— synthesis into AI output is expressly permitted by the publisher. · retrieved 2026-08-23 - Anthropic Connectors Directory entry — , read from our directory snapshot dated 2026-08-23 · retrieved 2026-08-23
- Twelve Data support
Use in Agentman
Connect once and your agents call these tools on their own — on a schedule, in a workflow, with nobody at the keyboard.
Open in Agentman StudioServer Info
- Category
- Finance
- Developer
- Twelve Data
- Tools
- 27
- Domain
- mcp.twelvedata.com
Using Claude Desktop or another MCP client? Setup docs — the connection URL above works anywhere.