Artha Council MCP Server
by akira231097io.github.akira231097/artha-councilv1.4.0
Auditable equity research and fail-closed broker execution for US and Indian cash equities.
context tax
queued
security
queued
cold start
queued
freshness
Maintained59d ago
Install Artha Council MCP server
Install in Claude Code
claude mcp add artha-council -e FMP_API_KEY='<fmp-api-key>' -e FINNHUB_API_KEY='<finnhub-api-key>' -e GOOGLE_API_KEY='<google-api-key>' -e TELEGRAM_BOT_TOKEN='<telegram-bot-token>' -e TELEGRAM_CHAT_ID='<telegram-chat-id>' -e UPSTOX_ACCESS_TOKEN='<upstox-access-token>' -e UPSTOX_SANDBOX_ACCESS_TOKEN='<upstox-sandbox-access-token>' -e KITE_API_KEY='<kite-api-key>' -e KITE_ACCESS_TOKEN='<kite-access-token>' -- docker run -i --rm -e FMP_API_KEY -e FINNHUB_API_KEY -e GOOGLE_API_KEY -e TELEGRAM_BOT_TOKEN -e TELEGRAM_CHAT_ID -e UPSTOX_ACCESS_TOKEN -e UPSTOX_SANDBOX_ACCESS_TOKEN -e KITE_API_KEY -e KITE_ACCESS_TOKEN ghcr.io/akira231097/artha-council-mcp:1.4.0Install in Cursor
{
"mcpServers": {
"artha-council": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FMP_API_KEY",
"-e",
"FINNHUB_API_KEY",
"-e",
"GOOGLE_API_KEY",
"-e",
"TELEGRAM_BOT_TOKEN",
"-e",
"TELEGRAM_CHAT_ID",
"-e",
"UPSTOX_ACCESS_TOKEN",
"-e",
"UPSTOX_SANDBOX_ACCESS_TOKEN",
"-e",
"KITE_API_KEY",
"-e",
"KITE_ACCESS_TOKEN",
"ghcr.io/akira231097/artha-council-mcp:1.4.0"
],
"env": {
"FMP_API_KEY": "<fmp-api-key>",
"FINNHUB_API_KEY": "<finnhub-api-key>",
"GOOGLE_API_KEY": "<google-api-key>",
"TELEGRAM_BOT_TOKEN": "<telegram-bot-token>",
"TELEGRAM_CHAT_ID": "<telegram-chat-id>",
"UPSTOX_ACCESS_TOKEN": "<upstox-access-token>",
"UPSTOX_SANDBOX_ACCESS_TOKEN": "<upstox-sandbox-access-token>",
"KITE_API_KEY": "<kite-api-key>",
"KITE_ACCESS_TOKEN": "<kite-access-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"artha-council": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FMP_API_KEY",
"-e",
"FINNHUB_API_KEY",
"-e",
"GOOGLE_API_KEY",
"-e",
"TELEGRAM_BOT_TOKEN",
"-e",
"TELEGRAM_CHAT_ID",
"-e",
"UPSTOX_ACCESS_TOKEN",
"-e",
"UPSTOX_SANDBOX_ACCESS_TOKEN",
"-e",
"KITE_API_KEY",
"-e",
"KITE_ACCESS_TOKEN",
"ghcr.io/akira231097/artha-council-mcp:1.4.0"
],
"env": {
"FMP_API_KEY": "<fmp-api-key>",
"FINNHUB_API_KEY": "<finnhub-api-key>",
"GOOGLE_API_KEY": "<google-api-key>",
"TELEGRAM_BOT_TOKEN": "<telegram-bot-token>",
"TELEGRAM_CHAT_ID": "<telegram-chat-id>",
"UPSTOX_ACCESS_TOKEN": "<upstox-access-token>",
"UPSTOX_SANDBOX_ACCESS_TOKEN": "<upstox-sandbox-access-token>",
"KITE_API_KEY": "<kite-api-key>",
"KITE_ACCESS_TOKEN": "<kite-access-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"artha-council": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FMP_API_KEY",
"-e",
"FINNHUB_API_KEY",
"-e",
"GOOGLE_API_KEY",
"-e",
"TELEGRAM_BOT_TOKEN",
"-e",
"TELEGRAM_CHAT_ID",
"-e",
"UPSTOX_ACCESS_TOKEN",
"-e",
"UPSTOX_SANDBOX_ACCESS_TOKEN",
"-e",
"KITE_API_KEY",
"-e",
"KITE_ACCESS_TOKEN",
"ghcr.io/akira231097/artha-council-mcp:1.4.0"
],
"env": {
"FMP_API_KEY": "<fmp-api-key>",
"FINNHUB_API_KEY": "<finnhub-api-key>",
"GOOGLE_API_KEY": "<google-api-key>",
"TELEGRAM_BOT_TOKEN": "<telegram-bot-token>",
"TELEGRAM_CHAT_ID": "<telegram-chat-id>",
"UPSTOX_ACCESS_TOKEN": "<upstox-access-token>",
"UPSTOX_SANDBOX_ACCESS_TOKEN": "<upstox-sandbox-access-token>",
"KITE_API_KEY": "<kite-api-key>",
"KITE_ACCESS_TOKEN": "<kite-access-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"artha-council": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FMP_API_KEY",
"-e",
"FINNHUB_API_KEY",
"-e",
"GOOGLE_API_KEY",
"-e",
"TELEGRAM_BOT_TOKEN",
"-e",
"TELEGRAM_CHAT_ID",
"-e",
"UPSTOX_ACCESS_TOKEN",
"-e",
"UPSTOX_SANDBOX_ACCESS_TOKEN",
"-e",
"KITE_API_KEY",
"-e",
"KITE_ACCESS_TOKEN",
"ghcr.io/akira231097/artha-council-mcp:1.4.0"
],
"env": {
"FMP_API_KEY": "<fmp-api-key>",
"FINNHUB_API_KEY": "<finnhub-api-key>",
"GOOGLE_API_KEY": "<google-api-key>",
"TELEGRAM_BOT_TOKEN": "<telegram-bot-token>",
"TELEGRAM_CHAT_ID": "<telegram-chat-id>",
"UPSTOX_ACCESS_TOKEN": "<upstox-access-token>",
"UPSTOX_SANDBOX_ACCESS_TOKEN": "<upstox-sandbox-access-token>",
"KITE_API_KEY": "<kite-api-key>",
"KITE_ACCESS_TOKEN": "<kite-access-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ARTHA_MCP_MARKET | — | — | Market profile: US or IN. |
| ARTHA_MCP_BROKER | — | — | Broker adapter: snapshot, upstox, zerodha, none, or plugin. |
| ARTHA_MCP_RESEARCH_MODE | — | — | Research boundary: embedded, host_orchestrated, or plugin. India should use host_orchestrated or a market-native plugin. |
| ARTHA_MCP_DATA_DIR | — | — | Persistent directory for journals, receipts, jobs, portfolio state, and audit artifacts. |
| ARTHA_MCP_ACCESS_MODE | — | — | Capability mode: read_only, operator, or trading. Defaults to read_only. |
| ARTHA_MCP_OPERATIONS_ENABLED | — | — | Explicit operations switch. Defaults to false. |
| ARTHA_MCP_TRADING_ENABLED | — | — | Explicit live-trading switch. Defaults to false. |
| ARTHA_MCP_KILL_SWITCH | — | — | Final MCP placement kill switch. Defaults to true. |
| ARTHA_MCP_MAX_ORDER_VALUE | — | — | Maximum value of one order in the selected market currency. Defaults to 25 USD or 2500 INR. |
| ARTHA_MCP_MAX_DAILY_ORDER_VALUE | — | — | Maximum total daily order value in the selected market currency. Defaults to 50 USD or 5000 INR. |
| ARTHA_MCP_MAX_DAILY_ORDERS | — | — | Maximum number of broker placements per market day. Defaults to 2. |
| ARTHA_MCP_MAX_PENDING_JOBS | — | — | Maximum queued or running allowlisted workflows. Defaults to 8 and prevents an unbounded work queue. |
| FMP_API_KEY | — | yes | Optional Financial Modeling Prep key for embedded US research. |
| FINNHUB_API_KEY | — | yes | Optional Finnhub key for embedded US research enrichment. |
| GOOGLE_API_KEY | — | yes | Optional Google Gemini key for embedded Council roles and web-grounded research. |
| TELEGRAM_BOT_TOKEN | — | yes | Optional Telegram bot token for Artha notifications. |
| TELEGRAM_CHAT_ID | — | yes | Optional Telegram destination used with TELEGRAM_BOT_TOKEN. |
| UPSTOX_ACCESS_TOKEN | — | yes | Upstox live account/read token used for portfolio, quote, margin, and fee proof. |
| UPSTOX_SANDBOX_ACCESS_TOKEN | — | yes | Separate Upstox sandbox token, required only when ARTHA_UPSTOX_SANDBOX=true. |
| ARTHA_INDIA_STATIC_IP_REGISTERED | — | — | Operator attestation that this deployment IP is registered with the selected Indian broker. |
| ARTHA_INDIA_DEMAT_SELL_AUTHORIZED | — | — | Operator attestation that required demat authorization is valid for Indian delivery sells. |
| ARTHA_UPSTOX_ALGO_NAME | — | — | Optional exchange-approved algo name configured in the Upstox app. |
| KITE_API_KEY | — | yes | Required only for the Zerodha adapter. |
| KITE_ACCESS_TOKEN | — | yes | Required only for the Zerodha adapter. |
Freshness
Maintained — last maintenance signal 59d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-11 · 59d ago · GitHub
Latest release
2026-08-11 · 59d ago · GitHub · v1.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-11 · 59d ago · official registry · v1.4.0
FAQ
›How do I install the Artha Council MCP server in Claude Code?
Run: claude mcp add artha-council -e FMP_API_KEY='<fmp-api-key>' -e FINNHUB_API_KEY='<finnhub-api-key>' -e GOOGLE_API_KEY='<google-api-key>' -e TELEGRAM_BOT_TOKEN='<telegram-bot-token>' -e TELEGRAM_CHAT_ID='<telegram-chat-id>' -e UPSTOX_ACCESS_TOKEN='<upstox-access-token>' -e UPSTOX_SANDBOX_ACCESS_TOKEN='<upstox-sandbox-access-token>' -e KITE_API_KEY='<kite-api-key>' -e KITE_ACCESS_TOKEN='<kite-access-token>' -- docker run -i --rm -e FMP_API_KEY -e FINNHUB_API_KEY -e GOOGLE_API_KEY -e TELEGRAM_BOT_TOKEN -e TELEGRAM_CHAT_ID -e UPSTOX_ACCESS_TOKEN -e UPSTOX_SANDBOX_ACCESS_TOKEN -e KITE_API_KEY -e KITE_ACCESS_TOKEN ghcr.io/akira231097/artha-council-mcp:1.4.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Artha Council require an API key?
Yes. It expects FMP_API_KEY, FINNHUB_API_KEY, GOOGLE_API_KEY, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, UPSTOX_ACCESS_TOKEN, UPSTOX_SANDBOX_ACCESS_TOKEN, KITE_API_KEY, KITE_ACCESS_TOKEN, of which 9 are secrets.
›Can I use Artha Council as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Artha Council in the official MCP registry?
Yes, as io.github.akira231097/artha-council.
Alternatives to Artha Council
Other science & research MCP servers.
WigoloActiveLocal web search, fetching, crawling, extraction and research, with multi-engine search, local ML reranking, a SQLite cache and JavaScript rendering.
ZoteroActiveSearch, read, annotate, and add to your Zotero research library, local or web.
ExaActiveConnect AI agents to Exa for web search, content fetching, and multi-step research.
PostgresMaintainedPostgres development and operations: performance analysis, tuning and health checks.
ArxivActiveSearch arXiv papers, read original LaTeX sections, get BibTeX from arXiv metadata and set topic watches, with papers stored locally.
Perplexity API PlatformActiveReal-time web search, reasoning, and research through Perplexity's API