What is it?

A universal financial toolkit that works with any AI agent platform via MCP (Model Context Protocol). Query market data, manage trading strategies, run remote AI research — accessible from Claude Code, Claude Desktop, Cursor, VS Code Copilot, Hermes, and 20+ other platforms. Also runs as a standalone terminal CLI.

Tool groups

Load only what you need with --tools=datahub,strategy,deepagent (any subset).

Quick Start

1. Interactive setup (recommended)

npx @openfinclaw/cli init

The wizard will:

• Ask for your Hub API Key (fch_..., required for Hub / DataHub tools)
• Optionally ask for your DeepAgent API Key (only if you enable the deepagent tool group)
• Let you pick tool groups
• Auto-detect installed platforms (by app bundles, user data dirs, CLI on PATH, or existing MCP config)
• Write MCP config to each selected platform
• Save keys to ~/.openfinclaw/config.json (chmod 600 on Unix) so the terminal CLI works without export

init also supports scripted, non-interactive use (useful on Windows / CI where raw-mode prompts don't work):

npx @openfinclaw/cli init --yes \
    --platforms cursor,claude-code \
    --tool-groups datahub,deepagent \
    --api-key fch_xxx \
    --deepagent-api-key <your-deepagent-key>

2. Manual MCP configuration

Drop this into your agent platform's MCP config file (path varies per platform — see below):

{
  "mcpServers": {
    "openfinclaw": {
      "command": "npx",
      "args": ["@openfinclaw/cli", "serve"],
      "env": {
        "OPENFINCLAW_API_KEY": "<your-hub-key>",
        "OPENFINCLAW_DEEPAGENT_API_KEY": "<your-deepagent-key>"
      }
    }
  }
}

Omit OPENFINCLAW_DEEPAGENT_API_KEY if you don't use the deepagent tool group.

3. Terminal CLI

For repeated terminal use, install globally so you can call openfinclaw directly instead of prefixing every command with npx:

npm install -g @openfinclaw/cli     # or: pnpm add -g @openfinclaw/cli
openfinclaw doctor                  # confirms the install + keys

Not installing globally? Every example below also works prefixed with npx -y @openfinclaw/cli (slower first run).

# Prices and K-lines
openfinclaw price AAPL
openfinclaw price BTC/USDT
openfinclaw kline 600519.SH --limit 30
openfinclaw compare AAPL,GOOGL,MSFT
openfinclaw search tesla

# Strategy management
openfinclaw leaderboard --limit 10
openfinclaw strategy-info <uuid>
openfinclaw fork <uuid>
openfinclaw validate ./my-strategy
openfinclaw publish ./my-strategy.zip

# DeepAgent — real token-by-token streaming in terminal
# Only requires OPENFINCLAW_DEEPAGENT_API_KEY (NOT the Hub fch_ key)
openfinclaw deepagent research "Write me a Tesla Bollinger Bands strategy and run a backtest"
openfinclaw deepagent skills
openfinclaw deepagent packages
openfinclaw deepagent download <package_id>

# Diagnostics (works with any subset of keys)
openfinclaw doctor

Hub key vs DeepAgent key. The two services authenticate independently. deepagent * and doctor run fine with only a DeepAgent key configured; price, kline, leaderboard, publish, etc. need the Hub fch_ key.

Supported Platforms

Platform config snippets

{
  "mcpServers": {
    "openfinclaw": {
      "command": "npx",
      "args": ["@openfinclaw/cli", "serve"],
      "env": { "OPENFINCLAW_API_KEY": "<your-hub-key>" }
    }
  }
}

{
  "mcpServers": {
    "openfinclaw": {
      "command": "npx",
      "args": ["@openfinclaw/cli", "serve"],
      "env": { "OPENFINCLAW_API_KEY": "<your-hub-key>" }
    }
  }
}

{
  "servers": {
    "openfinclaw": {
      "command": "npx",
      "args": ["@openfinclaw/cli", "serve"],
      "env": { "OPENFINCLAW_API_KEY": "<your-hub-key>" }
    }
  }
}

mcp_servers:
  openfinclaw:
    command: "npx"
    args: ["@openfinclaw/cli", "serve"]
    env:
      OPENFINCLAW_API_KEY: "<your-hub-key>"
      OPENFINCLAW_DEEPAGENT_API_KEY: "<your-deepagent-key>"

{
  "mcp": {
    "openfinclaw": {
      "type": "local",
      "command": ["npx", "@openfinclaw/cli", "serve"],
      "environment": { "OPENFINCLAW_API_KEY": "<your-hub-key>" },
      "enabled": true
    }
  }
}

Configuration

API Keys (two independent keys)

Either key is optional on its own — the CLI lets you run the subcommands that match whichever keys you have. doctor skips the Hub connectivity check when no Hub key is present.

Resolution order for each key (highest first):

1. CLI flag: --api-key <key> / --deepagent-api-key <key>
2. Environment variable
3. ~/.openfinclaw/config.json (written by openfinclaw init)

Get keys at hub.openfinclaw.ai.

Environment variables

Streaming & long-running tools

DeepAgent research runs can take 3–10 minutes. Two access patterns:

• Terminal CLI (openfinclaw deepagent research "..."): true token-by-token streaming directly to stdout
• MCP clients: the research workflow is split into three calls — fin_deepagent_research_submit (returns a taskId immediately), fin_deepagent_research_poll (every 30–60 s for progress), fin_deepagent_research_finalize (fetch full result). The agent drives this loop itself — works consistently across Claude Desktop, Cursor, Hermes, Windsurf, and other MCP clients.

Related

• @openfinclaw/core — Platform-independent library core. Use directly only if you are building a custom MCP wrapper.
• GitHub — source, issues, Chinese README.

License

MIT