twelve-data

This MCP server exposes a set of financial data tools backed by the Twelve Data API. It provides access to real-time price data, time series, and common technical indicators through the MCP interface. Tools available include GetRealTimePrice, GetTimeSeries, GetMovingAverage, GetRelativeStrengthIndex, GetBollingerBands, GetAvarageDirectionalIndex, GetAvarageTrueRange, and GetSupportResistance. To use it, configure your MCP client (e.g., Claude Desktop or Cursor.ai) with the t twelve-data entry under mcpServers and provide your Twelve Data API key. The server handles requests to fetch data from Twelve Data and returns structured results suitable for downstream analysis, charting, or prompting your AI assistant with up-to-date market insights.

Prerequisites:

• Node.js (recommended LTS) and npm installed on your machine
• Access to the internet to fetch the MCP server package from npm

Step-by-step:

1. Verify Node.js and npm are installed: node -v npm -v
2. Use npx to run the Twelve Data MCP server with your API key (no global install required): npx -y twelve-data-mcp-server --apikey YOUR_TWELVE_DATA_API_KEY
3. If you prefer to install the package locally, you can initialize a project and install the package: mkdir twelve-data-mcp && cd twelve-data-mcp npm init -y npm i twelve-data-mcp-server npx twelve-data-mcp-server --apikey YOUR_TWELVE_DATA_API_KEY
4. Configure your MCP client by adding the following to the mcpServers section of your configuration file: { "mcpServers": { "twelve-data": { "command": "npx", "args": [ "-y", "twelve-data-mcp-server", "--apikey", "YOUR_TWELVE_DATA_API_KEY" ] } } }

Notes:

• The server reads the API key from the configuration argument or environment variable if configured. Ensure your key has the required Twelve Data plan for the data you request.
• If you deploy in an environment, consider storing the API key securely and referencing it via an environment variable rather than hardcoding it.

Tips and common issues:

• Ensure your Twelve Data API key is active and has permissions for the requested data (real-time, intraday, or historical time series).
• If requests fail due to authentication, verify that the API key is correctly passed in the command or via environment variable TWELVE_DATA_API_KEY.
• Some environments may block outbound HTTPS; ensure network egress to api.twelvedata.com is allowed.
• Be mindful of rate limits set by Twelve Data; implement appropriate caching in your client if you plan to query frequently.
• The server name in your MCP configuration is case-sensitive; use the exact key used in the mcpServers map (e.g., twelve-data).
• If you upgrade the server, recheck the command and arguments as the MCP interface may expect updated parameters for new tools or indicators.