Connector guide5-minute read19 MCP tools7 languages

How to Connect Twelve Data to Gemini — via MCP

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

HCBy HelpCode teamUpdated 5 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Twelve Data

Twelve Data

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

tools

19

Region

INTL

Category

Finance

Authentication

API Key

Required env vars

TWELVE_DATA_API_KEY
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the Twelve Data in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

Summary

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

Try asking

Example prompts for Twelve Data

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Twelve Data · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Twelve Data, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Twelve Data + Gemini

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

TWELVE_DATA_API_KEY

Step 1 — Get credentials

  1. Create a free account at https://twelvedata.com and open API Keys in the dashboard.
  2. Copy the key into TWELVE_DATA_API_KEY. It is sent in the Authorization: apikey header, so it never appears in a URL or a log.
  3. Resolve a name into a symbol with twelve_data_search_symbols (for example Siemens to SIE on XETR), then call twelve_data_get_price, twelve_data_get_quote or twelve_data_get_time_series. For currencies use twelve_data_get_exchange_rate or twelve_data_convert_currency with a pair such as EUR/USD.

The free Basic plan allows 8 API credits per minute and 800 per day; most tools cost 1 credit per symbol. Above that the API answers 429 until the next minute. Free plans cover US equities, forex and crypto; many non-US exchanges and fundamentals need a paid plan and answer 403. twelve_data_get_api_usage shows your usage against the plan limits. Prices come back as strings, newest first unless order is asc.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
  2. Save the file and restart gemini.
  3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
  4. Start prompting — Gemini CLI can now call the Twelve Data tools.

Available tools

ToolWhat it does
twelve_data_get_api_usageShow the requests made in the last minute and today, the plan's per-minute and daily limits, and the plan category
twelve_data_get_quoteReal-time quote for one instrument: name, exchange, currency, open, high, low, close, volume, previous close, change and percent change…
twelve_data_get_priceLatest traded price of one instrument as a single number
twelve_data_get_time_seriesHistorical OHLCV bars for one instrument at an interval (1min to 1month): meta (symbol, currency, exchange, timezone) and values with…
twelve_data_get_eodClosing price of the last trading day (or of a given date) for one instrument, with exchange, currency and datetime. 1 credit per symbol
twelve_data_get_exchange_rateReal-time exchange rate of a forex or crypto pair, for example EUR/USD or BTC/ETH, with its timestamp
twelve_data_convert_currencyConvert an amount from the base to the quote currency of a forex or crypto pair at the real-time (or a historical) rate
twelve_data_search_symbolsFind instruments by ticker or name, ordered by relevance: symbol, instrument name, exchange, MIC, currency, country and type
twelve_data_list_stocksList stock symbols covered by Twelve Data, updated daily: symbol, name, currency, exchange, MIC, country, type
twelve_data_list_forex_pairsList the forex pairs available, updated daily: symbol (for example EUR/USD), currency group, base and quote currency
twelve_data_list_cryptocurrenciesList the cryptocurrency pairs available, updated daily: symbol (for example BTC/USD), the exchanges that quote it, base and quote currency
twelve_data_list_exchangesList equity exchanges: name, MIC code, country, timezone and access plan
twelve_data_get_earliest_timestampReturn the earliest date and time for which data exists for an instrument at an interval
twelve_data_get_market_stateShow whether stock exchanges are open now, with time to open, time to close and time since open
twelve_data_get_rsiRelative Strength Index (0 to 100) series for an instrument; above 70 is commonly read as overbought, below 30 as oversold
twelve_data_get_macdMoving Average Convergence Divergence series for an instrument: macd line, signal line and histogram per datetime, to spot trend changes. 1…
twelve_data_get_smaSimple Moving Average series for an instrument over time_period bars, for trend direction and support levels. 1 credit per symbol
twelve_data_get_emaExponential Moving Average series for an instrument over time_period bars; reacts faster to recent prices than the SMA. 1 credit per symbol
twelve_data_get_bbandsBollinger Bands series for an instrument: upper band, middle band (moving average) and lower band per datetime, to judge volatility. 1…

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

Was this guide helpful?

Your Twelve Data agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Related guides

Connectors

How to Connect Twelve Data to ChatGPT — via MCP

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

Connectors

How to Connect Twelve Data to Claude — via MCP

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

Connectors

How to Connect Twelve Data to Cursor — via MCP

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

Connectors

How to Connect Twelve Data to Meta Muse — via MCP

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

Connectors

Twelve Data to MCP — Drive Twelve Data from any AI Agent

Market data for AI agents from Twelve Data: real-time quotes and prices, historical time series, exchange rates and currency conversion, symbol search, stock, forex and crypto lists, exchanges and market hours, and RSI, MACD, SMA, EMA and Bollinger Bands. 19 read-only tools, API key.

Connectors

How to Connect Outlook (Microsoft 365 Mail and Calendar) to Gemini — via MCP

Let your AI work in Outlook: search and read email, file messages in folders, draft, send and reply, check the calendar, create and move meetings, and find free time with colleagues. Microsoft 365 and Outlook.com through Microsoft Graph, signed in with your Microsoft account.