Twelve Data is the financial-market data API many fintech products build on — stocks, ETFs, forex, indices, crypto, in one normalised API. Connecting Twelve Data to clariBI brings live market context into your AI analyses.
Why connect Twelve Data
Market questions ("how did our portfolio compare to the S&P 500 last quarter?") usually require manual data pulls or scripted notebooks.
With Twelve Data connected, you can ask "Compare AAPL and MSFT daily returns last month", "Show me top crypto by volume today", or "FX rate trend EUR/USD over 90 days" and the AI engine routes through the hosted MCP.
How the connection works
clariBI talks to Twelve Data through its hosted MCP server at https://mcp.twelvedata.com/mcp. Authentication uses an API key you generate in your vendor account. Tokens stay encrypted server-side and never leave clariBI in clear form.
sequenceDiagram
actor U as You
participant C as clariBI
participant V as Twelve Data
U->>V: Generate an API key in Twelve Data dashboard
U->>C: Paste the key into the connect wizard
C->>V: list_tools (verify the key)
V-->>C: Tools available
C->>C: Encrypt and store credentials
C-->>U: Connection ready
Available tools
clariBI exposes the read-only Twelve Data tools that the vendor's MCP server publishes at connection time. Write operations (create, update, delete, send, refund) are filtered out by a name-pattern blocklist before any tool reaches the analysis engine, so connecting Twelve Data cannot modify data on the vendor side.
The exact tool inventory depends on the Twelve Data features your account has access to. After connecting, try a few natural-language questions to see what Twelve Data data clariBI can pull.
Data flow during analysis
When you ask a question that maps to Twelve Data, the AI engine routes to the right tool, reads the result, and pairs the answer with a chart you can pin to a dashboard.
sequenceDiagram
actor U as You
participant C as clariBI
participant AI as AI engine
participant V as Twelve Data
U->>C: Ask a question about real-time and historical financial market data
C->>AI: Plan the analysis
AI->>V: Call the right tool
V-->>AI: Tool result
AI->>AI: Summarize and chart
C-->>U: Answer plus visual
Setting up the connection
- Open Data Sources in the clariBI sidebar.
- Click Add data source.
- Open the MCP Servers tab.
- Click the Twelve Data card.
- In a new tab, sign in to Twelve Data and generate a read-only API key.
- Paste the key into clariBI and click Connect.
- Give your data source a name.
- Click Finish.
Permissions and data access
API-key authentication via the Authorization: apikey <KEY> header. The key is read-only against Twelve Data — no orders or portfolio changes possible. Revoke from the Twelve Data Dashboard anytime.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| "401 Unauthorized" | The API key was revoked or rate-limited. | Regenerate the key in your Twelve Data Dashboard, then update it in clariBI Settings → Integrations. |
| "Quota exceeded" | Twelve Data enforces per-plan rate limits. | Wait for the quota window, narrow the query, or upgrade your Twelve Data plan. |