Okama MCP

MCP (Model Context Protocol) server that exposes the okama investment portfolio toolkit to AI assistants - Claude Desktop, Claude Code, Cursor, Codex, and any other MCP-compatible client. It runs locally over stdio via the published package.

People connecting data & analytics tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-20 · ★ 4 · #27 OF 75 MAINTAINED DATA & ANALYTICS · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Okama MCP

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add mbk-dev-okama-mcp -- uvx okama-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mbk-dev-okama-mcp": {
      "command": "uvx",
      "args": [
        "okama-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package okama-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.mbk-dev is GitHub-verified and matches the repo owner

03 · What Okama MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Limitations (from the README)

[!WARNING] <sub With pip, prefer a dedicated virtual environment: on most modern Linux distros the system Python is marked externally managed (PEP 668), so pip install outside a venv fails, and a shared environment risks dependency conflicts. In your MCP client config, point command at the absolute path of the okama-mcp script inside the venv - GUI

Latest releases

v1.7.0 · 2026-08-20

New · search_assets can browse a namespace without a text query, filter by exact asset type, and rank results by the earliest first_date. · search_assets results and get_asset_info now expose each asset’s local_name.…

v1.6.1 · 2026-06-22

Fixed · list_namespaces no longer crashes with dictionary update sequence element #1 has length 3; 2 is required when called with kind="assets" or kind="macro". okama 2.2 returns a bare list of codes (not a {code…

v1.6.0 · 2026-06-17

What's new · get_indicator - macro indicators in the RATIO namespace (CAPE10 by country, e.g. USA_CAPE10.RATIO, EUR_CAPE10.RATIO). Optional include_describe for multi-horizon stats. · plot_macro - line chart of macro…

04 · Who maintains Okama MCP

okama-mcp is maintained by mbk-dev. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

repository: github.com/mbk-dev/okama-mcp
category: data & analytics - ranked #27 of 75 actively-maintained data & analytics servers as of 2026-08-25.
release cadence: 10+ releases in the last 90 days (latest 2026-08-20)
registry: io.github.mbk-dev/okama-mcp (active, first published 2026-06-05 · 8 versions)
packages: pypi:okama-mcp

06 · Okama MCP FAQ

What is Okama MCP?

Is Okama MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-20 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Okama MCP?

Run `uvx okama-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Okama MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Okama MCP

Alternatives to Okama MCP

Maintained data & analytics servers if Okama MCP isn't the fit.

Pairs well with

Servers that cover what Okama MCP doesn't - only shown when the pairing reason fits the companion.

More data & analytics MCP servers · Instagram MCP · Gtm Ga4 · Gsc · Umami · Muxinc MCP Server

More Python MCP servers · Tenkai MCP · Hangar · MCPAmpel - MCP Security Scanner · Mcpcap · see all