Mmcp.market

Capital.com MCP Server

by SimonTarara62·io.github.SimonTarara62/capitalcom-mcp-server·v0.3.4
No reviews yet

Unofficial community MCP for the Capital.com Open API. Guarded two-phase trades; demo-first.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

0 stars34 downloads/wk

Reviews

Write one

Nobody has reviewed Capital.com MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Capital.com MCP Server tools (42, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cap_account_demo_topup

    Top up the demo account balance (DEMO ONLY). The SDK enforces demo + confirm.

  • cap_account_history_activity

    Get account activity history (deals, orders, updates). detailed adds fields; deal_id filters.

  • cap_account_history_transactions

    Get transaction history (deposits, withdrawals, P&L). Optional type filter.

  • cap_account_list

    List all trading accounts (balance, currency, type). Requires authentication.

  • cap_account_preferences_get

    Get account preferences (hedging mode, per-asset-class leverage).

  • cap_account_preferences_set

    Set account preferences (TRADE-GATED). Requires confirm=true when configured.

  • cap_market_get

    Get full market details and dealing rules for an EPIC.

  • cap_market_navigation_node

    Get child nodes/markets under a navigation node.

  • cap_market_navigation_root

    Get the root market-navigation tree (categories).

  • cap_market_prices

    Get historical OHLC candles. resolution e.g. MINUTE_15, HOUR, DAY.

  • cap_market_search

    Search markets by term or EPIC list. limit truncates results client-side.

  • cap_market_sentiment

    Get client sentiment (long vs short %) for a market.

  • cap_session_loginwrite action

    Create or verify a session. force=true re-logs in; account_id switches account.

  • cap_session_logout

    End the session and clear tokens. Requires authentication.

  • cap_session_ping

    Keep the session alive (extends timeout). Requires authentication.

  • cap_session_status

    Get current session status (login state, account, token expiry). No auth required.

  • cap_session_switch_account

    Switch the active trading account by ID. Requires authentication.

  • cap_stream_alerts

    Monitor EPICs for price-level crossings. alerts: {EPIC: {level, direction: ABOVE|BELOW}}.

  • cap_stream_candles

    Stream live OHLC bars for up to 40 EPICs at the given resolutions (WebSocket).

  • cap_stream_portfolio

    Stream live portfolio snapshots for open positions for duration_s seconds (WebSocket).

  • cap_stream_prices

    Stream live bid/offer for up to 40 EPICs for duration_s seconds (WebSocket).

  • cap_trade_confirm_get

    Get deal-confirmation status (ACCEPTED/REJECTED/pending) for a deal reference.

  • cap_trade_confirm_wait

    Poll the confirmation endpoint until ACCEPTED/REJECTED or timeout.

  • cap_trade_execute_positionwrite action

    Execute a previewed position (CREATES A REAL TRADE). SDK enforces all safety gates.

  • cap_trade_execute_working_orderwrite action

    Execute a previewed working order (CREATES A REAL ORDER). SDK enforces all safety gates.

  • cap_trade_orders_amend

    Amend a working order's level/expiry/stops-limits (SIDE EFFECT). Requires confirm.

  • cap_trade_orders_cancelwrite action

    Cancel a working order (SIDE EFFECT). Requires confirm + trading enabled.

  • cap_trade_orders_list

    List all working orders (pending LIMIT/STOP that haven't triggered).

  • cap_trade_positions_amend

    Amend stop-loss / take-profit on an open position (SIDE EFFECT). Requires confirm.

  • cap_trade_positions_close

    Close an open position (SIDE EFFECT). Requires confirm + trading enabled.

  • cap_trade_positions_get

    Get a single position's details by deal ID.

  • cap_trade_positions_list

    List all open positions (P&L, direction, size, attached orders).

  • cap_trade_preview_position

    Preview a position (NO SIDE EFFECTS). Runs the full risk pipeline; returns preview_id.

  • cap_trade_preview_working_orderwrite action

    Preview a working order (NO SIDE EFFECTS). type is LIMIT or STOP. Returns preview_id.

  • cap_watchlists_add_market

    Add a market (EPIC) to a watchlist. Requires confirm when configured.

  • cap_watchlists_createwrite action

    Create a new watchlist (1-100 chars). Requires confirm when configured.

  • cap_watchlists_deletewrite action

    Delete a watchlist. Requires confirm when configured.

  • cap_watchlists_get

    Get a watchlist's details including its markets.

  • cap_watchlists_list

    List all watchlists (IDs and names).

  • cap_watchlists_remove_marketwrite action

    Remove a market (EPIC) from a watchlist. Requires confirm when configured.

  • fetch

    ChatGPT Deep Research: fetch a market's details. Returns {id,title,text,url,metadata}.

  • search

    ChatGPT Deep Research: search Capital.com markets. Returns {results:[{id,title,url}]}.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 20 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

What the publisher says

From the Capital.com MCP Server repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.SimonTarara62/capitalcom-mcp-server -->

Capital.com MCP Server

Self-hosted Model Context Protocol (MCP) server for the Capital.com Open API, written in Python on FastMCP. It exposes 42 safe, guarded trading and market-data tools — two-phase execution, allowlists, demo-first — to any MCP client, over stdio or HTTP. Built on the tested capitalcom-cli broker engine (SDK).

Works with Claude Desktop · Claude Code · Cursor · VS Code (Copilot) · Windsurf · ChatGPT — any MCP client.

⚠️ Unofficial & educational. Not affiliated with Capital.com. Trading is

risky and this is not financial advice. Trading is disabled by default;

all trades are two-phase (preview → confirm → execute) with allowlists and

size/rate limits. Start on a demo account. Apache-2.0 licensed.

Install

No clone required — uvx runs it in an isolated, throwaway environment and always fetches the latest tested release:

uvx capitalcom-mcp --help        # smoke test

Or install a persistent command with pipx:

pipx install capitalcom-mcp

Pinning for production / real-money use

uvx capitalcom-mcp always runs the latest published release. That is fine for trying it out, but for production or real-money use, pin the exact version so an unexpected update can't change tool behavior under you:

{
  "mcpServers": {
    "capitalcom": {
      "command": "uvx",
      "args": ["capitalcom-mcp==0.3.4"],
      "env": { "CAP_ENV_FILE": "/Users/you/.config/capital-mcp/.env" }
    }
  }
}

The CLI form is uvx capitalcom-mcp==0.3.4 run …. Pin to a version you have reviewed, and bump deliberately after reading the CHANGELOG.

1. Add your credentials (once)

Get an API key in the Capital.com app: Settings → API integrations (make a demo key first). Then run the wizard — it writes a 0600 file and prints the exact client snippet:

uvx capitalcom-mcp init

This writes ~/.config/capital-mcp/.env. Verify any time (no secrets printed):

uvx capitalcom-mcp doctor

Inspect the full effective configuration (redacted, offline) or confirm your credentials actually authenticate:

uvx capitalcom-mcp config          # effective settings + credential source
uvx capitalcom-mcp doctor --login  # verify authentication against the API

Prefer a secret manager? Set CAPAPIKEYCMD / CAPIDENTIFIERCMD / CAPAPIPASSWORDCMD to a command that prints the secret (e.g. op read op://vault/..., pass ...). The secret is fetched at launch and never written to disk or to your client config.

2. Add the server to your client

Every client uses the same command/args/env shape. Pasting "CAPENVFILE": "" keeps secrets out of the client file; or put CAPAPIKEY/CAPIDENTIFIER/CAPAPI_PASSWORD directly in env.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

claude mcp add capitalcom-mcp-server -- uvx capitalcom-mcp
Add to Cursor

Capital.com MCP Server: common questions

Is Capital.com MCP Server safe?
Mostly: it is graded B (83/100). Read the Capital.com MCP Server safety report
How do I install Capital.com MCP Server?
It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Capital.com MCP Server need an API key?
Yes. The registry entry asks for CAP_API_KEY, CAP_IDENTIFIER, CAP_API_PASSWORD.
Is Capital.com MCP Server maintained?
The last commit was 20 days ago (2026-09-07). The latest release is v0.3.4.

More from SimonTarara62 →