Artha Council MCP Server

io.github.akira231097/artha-council

Repository Registry

What is the Artha Council MCP server?

Auditable equity research and fail-closed broker execution for US and Indian cash equities.

How to install Artha Council

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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
secret
Optional Financial Modeling Prep key for embedded US research.
FINNHUB_API_KEY
secret
Optional Finnhub key for embedded US research enrichment.
GOOGLE_API_KEY
secret
Optional Google Gemini key for embedded Council roles and web-grounded research.
TELEGRAM_BOT_TOKEN
secret
Optional Telegram bot token for Artha notifications.
TELEGRAM_CHAT_ID
secret
Optional Telegram destination used with TELEGRAM_BOT_TOKEN.
UPSTOX_ACCESS_TOKEN
secret
Upstox live account/read token used for portfolio, quote, margin, and fee proof.
UPSTOX_SANDBOX_ACCESS_TOKEN
secret
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
secret
Required only for the Zerodha adapter.
KITE_ACCESS_TOKEN
secret
Required only for the Zerodha adapter.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "artha-council": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/akira231097/artha-council-mcp:1.4.0"
      ],
      "env": {
        "ARTHA_MCP_MARKET": "<YOUR_ARTHA_MCP_MARKET>",
        "ARTHA_MCP_BROKER": "<YOUR_ARTHA_MCP_BROKER>",
        "ARTHA_MCP_RESEARCH_MODE": "<YOUR_ARTHA_MCP_RESEARCH_MODE>",
        "ARTHA_MCP_DATA_DIR": "<YOUR_ARTHA_MCP_DATA_DIR>",
        "ARTHA_MCP_ACCESS_MODE": "<YOUR_ARTHA_MCP_ACCESS_MODE>",
        "ARTHA_MCP_OPERATIONS_ENABLED": "<YOUR_ARTHA_MCP_OPERATIONS_ENABLED>",
        "ARTHA_MCP_TRADING_ENABLED": "<YOUR_ARTHA_MCP_TRADING_ENABLED>",
        "ARTHA_MCP_KILL_SWITCH": "<YOUR_ARTHA_MCP_KILL_SWITCH>",
        "ARTHA_MCP_MAX_ORDER_VALUE": "<YOUR_ARTHA_MCP_MAX_ORDER_VALUE>",
        "ARTHA_MCP_MAX_DAILY_ORDER_VALUE": "<YOUR_ARTHA_MCP_MAX_DAILY_ORDER_VALUE>",
        "ARTHA_MCP_MAX_DAILY_ORDERS": "<YOUR_ARTHA_MCP_MAX_DAILY_ORDERS>",
        "ARTHA_MCP_MAX_PENDING_JOBS": "<YOUR_ARTHA_MCP_MAX_PENDING_JOBS>",
        "FMP_API_KEY": "<YOUR_FMP_API_KEY>",
        "FINNHUB_API_KEY": "<YOUR_FINNHUB_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "TELEGRAM_BOT_TOKEN": "<YOUR_TELEGRAM_BOT_TOKEN>",
        "TELEGRAM_CHAT_ID": "<YOUR_TELEGRAM_CHAT_ID>",
        "UPSTOX_ACCESS_TOKEN": "<YOUR_UPSTOX_ACCESS_TOKEN>",
        "UPSTOX_SANDBOX_ACCESS_TOKEN": "<YOUR_UPSTOX_SANDBOX_ACCESS_TOKEN>",
        "ARTHA_INDIA_STATIC_IP_REGISTERED": "<YOUR_ARTHA_INDIA_STATIC_IP_REGISTERED>",
        "ARTHA_INDIA_DEMAT_SELL_AUTHORIZED": "<YOUR_ARTHA_INDIA_DEMAT_SELL_AUTHORIZED>",
        "ARTHA_UPSTOX_ALGO_NAME": "<YOUR_ARTHA_UPSTOX_ALGO_NAME>",
        "KITE_API_KEY": "<YOUR_KITE_API_KEY>",
        "KITE_ACCESS_TOKEN": "<YOUR_KITE_ACCESS_TOKEN>"
      }
    }
  }
}