Twelve Data MCP

Live

API KEY

ANALYTICS

Analytics

Connect to Twelve Data MCP to fetch real-time and historical stock, forex, crypto, and ETF market data for your AI financial analysis workflows.

  • Acts as the user: Every tool call runs as the authorizing user. Access and audit trail stay intact.
  • Credentials stay vaulted: AES-256 encrypted, resolved at request time, never stored in LLM context.
  • Scoped before every call: Per-user permissions enforced automatically. 90-day audit trail included.
Twelve Data MCP
agent · Acme Q3
Run
Currency Conversion in Twelve Data MCP
S
twelvedatamcp_currency_conversion
85ms
Twelve Data MCP agent
Get exchange rate or convert an amount between currencies (fiat or crypto). provide the currency pair as symbol (e.g. 'e.
Sources: Twelve Data MCP
twelvedatamcpmcp
1 tool call
18:29
Message Claude...

Twelve Data MCP tools for AI agents

CALL ANY TOOL
8 tools covering get, search, convert.
twelvedatamcp_currency_conversion
Get exchange rate or convert an amount between currencies (f
Get exchange rate or convert an amount between currencies (fiat or crypto). provide the currency pair as symbol (e.g. 'eur/usd', 'btc/usd', 'gbp/jpy'). optionally provide an amount to get the converted value, or a date (yyyy-mm-dd) for a historical rate. omit date for the real-time rate. use for: 'eur to usd', 'convert 1000 jpy to gbp', 'btc price in eur'.
Parameters
Name
Type
Required
Description
symbol
string
Required
Currency pair in the format BASE/QUOTE, e.g. 'EUR/USD', 'BTC/USD', 'GBP/JPY'.
amount
number
Optional
Amount to convert. If provided, the response includes the converted value for this amount.
date
string
Optional
Date for a historical exchange rate in YYYY-MM-DD format. Omit for the real-time rate.
twelvedatamcp_get_analyst_data
Get analyst ratings, consensus price targets, and forward es
twelvedatamcp_get_api_usage
Check twelve data api credit consumption and plan limits. us
twelvedatamcp_get_company_info
Get company profile, executives, or logo. data_type='profile
twelvedatamcp_get_company_news
Get the latest news, press releases, and announcements for a
twelvedatamcp_get_dividends
Get dividend history for a stock or the upcoming dividend ca
twelvedatamcp_get_earliest_timestamp
Get the earliest available datetime for an instrument at a g
twelvedatamcp_get_earnings
Get earnings data or the market-wide earnings calendar. use
twelvedatamcp_get_etf_data
Get etf analytics. data_type controls what is returned: 'sum
twelvedatamcp_get_financials
Get financial statements for a company. statement='income_st
twelvedatamcp_get_ipo_calendar
Get the ipo calendar -- upcoming and recent initial public o
twelvedatamcp_get_market_cap
Get market capitalization for a company. without date params
Build your Agent
Same auth pattern across every framework.
Python · LlamaIndex
from langchain_mcp_adapters.client import MultiServerMCPClient
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="twelvedatamcp")

mcp = MultiServerMCPClient({
"twelvedatamcp": {
"url": "https://mcp.scalekit.com/twelvedatamcp",
"headers": {"Authorization": "Bearer " + token}
}
})
tools = await mcp.get_tools()
import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "twelvedatamcp" });

const openai = new OpenAI();
// Connect to MCP at https://mcp.scalekit.com/twelvedatamcp
// Pass: Authorization: Bearer + token
import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "twelvedatamcp" });

const anthropic = new Anthropic();
// Connect to MCP at https://mcp.scalekit.com/twelvedatamcp
// Pass: Authorization: Bearer + token
from google.adk.agents import LlmAgent
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="twelvedatamcp")
# Connect to MCP at https://mcp.scalekit.com/twelvedatamcp
# Pass: Authorization: Bearer + token
Try these prompts
Paste any prompt into your agent to get started.
Get started
Copy the prompt
Copied
Search for financial instruments by name or partial ticker, or find cross-listings?
Copy the prompt
Copied
Get historical OHLCV (Open, High, Low, Close, Volume) time series data?
Advanced
Copy the prompt
Copied
Get exchange rate or convert an amount between currencies (fiat or crypto)?
SEE HOW AUTH WORKS
User authorises once. Every agent call after uses their token with scope enforcement.
1
Authorize
Your user connects
Twelve Data MCP
once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access
Who:
user ‘A’
when:
Once per user
access:
Limited to user
2
Store
Their
Twelve Data MCP
token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection
vault:
encrypted
scope:
per-user
tokens:
auto-refreshed
3
Resolve
When your agent calls a
Twelve Data MCP
tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs
speed:
~40ms
check:
before every call
seen by:
nobody
4
Audit
Every
Twelve Data MCP
tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it
history:
90 days
export:
SIEM-ready
logged:
every call
Test other agents
See the same per-user auth pattern across other connectors.
SALES
Deal intelligence agent
Combine Gong, Attio, and Slack signals to surface deal risks and next-best actions. Updated after every call.
ENGINEERING
Engineering standup agent
Aggregate GitHub and GitLab activity, link to Jira, and post a daily standup digest to Slack. No async updates.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
Other connector libraries treat auth as a demo afterthought.
01.
Shared tokens break per-user analytics
A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential.
// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓
02.
Authentication is not authorization
03.
Multi-tenancy is architectural
04.
One connector today. Ten tomorrow.
“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”
Venu Madhav Kattagoni
Head of Engineering / Von
FAQs
Frequently Asked Questions

Does the agent access Twelve Data as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.

Where is the Twelve Data API key stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.

Can I limit what the agent is allowed to do in Twelve Data?
Yes. Pass a tool name filter to listScopedTools so the analytics agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Twelve Data.

What happens when a user revokes Twelve Data access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Whose market data plan do quote requests count against?
The authorizing user's Twelve Data plan. Quotes, indicators, and analyst data draw from that user's rate limits, so one heavy analyst cannot exhaust a shared key for everyone.

Start in your coding agent
Up and running in one command
Install the Scalekit skill in your editor of choice. Connector, auth, tools, prompt, all wired up
Claude Code REPL
/plugin marketplace add scalekit-inc/claude-code-authstack
/plugin install agentkit@scalekit-auth-stack
Cursor Code REPL
# ~/.cursor/mcp.json
{
""mcpServers"": {
""twelvedatamcp"": {
""url"": ""https://mcp.scalekit.com/twelvedatamcp"",
""headers"": { ""Authorization"": ""Bearer $SCALEKIT_TOKEN"" }
}
}
}
Codex Code REPL
# ~/.codex/config.toml
[mcp_servers.twelvedatamcp]
url = ""https://mcp.scalekit.com/twelvedatamcp""
auth_env = ""SCALEKIT_TOKEN""
Copilot Code REPL
# .vscode/mcp.json
{
""servers"": {
""twelvedatamcp"": {
""url"": ""https://mcp.scalekit.com/twelvedatamcp"",
""type"": ""http""
}
}
}