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)
• 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

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

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

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

# DeepAgent — real token-by-token streaming in terminal
npx @openfinclaw/cli deepagent research "Analyze BTC trend over last 30 days"
npx @openfinclaw/cli deepagent skills
npx @openfinclaw/cli deepagent packages
npx @openfinclaw/cli deepagent download <package_id>

# Diagnostics
npx @openfinclaw/cli doctor

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)

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