Skip to main content

investgame-mcp

MCP server for InvestGame Arcadia — gaming industry investment deals and company data.

Search 8,600+ gaming companies, 5,200+ M&A/investment deals, investor analytics, and portfolio exits.

No installation needed. Connect InvestGame directly in Claude.ai in under 60 seconds:

  1. Open Claude.ai Settings → Connectors
  2. Click "Add custom connector"
  3. Enter URL: https://app.investgame.net/mcp
  4. Claude will open the InvestGame authorize page — enter your API key
  5. Done — InvestGame tools available in every conversation

Get an API key: Go to app.investgame.net/profile → click Reveal Key → copy it.

⚠️ Enable tool permissions. After connecting, click Configure next to InvestGame in the Connectors list. Set Tool permissions to "Needs approval" or "Always allow" for both InvestGame tools. Without this, Claude will say tools are "not currently available".


Local Installation (Claude Desktop / Claude Code)

For local setups where you run Claude Desktop or Claude Code on your machine.

All Installation Methods

Prerequisites

Install uvx — a command from the uv Python package manager:

OS Command
macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh
Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

After installing, restart your terminal (or reboot on Windows) so uvx is available.

Don't want to install uv? Use pip install method instead — it works with any Python 3.12+ installation.

Config file locations

OS Config file path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json
Claude Code .mcp.json in project root
{
  "mcpServers": {
    "investgame": {
      "command": "uvx",
      "args": ["investgame-mcp"],
      "env": { "INVESTGAME_API_KEY": "your-key" }
    }
  }
}

Restart Claude Desktop. Done — both InvestGame tools available.

2. pip install

pip install investgame-mcp
{
  "mcpServers": {
    "investgame": {
      "command": "investgame-mcp",
      "env": { "INVESTGAME_API_KEY": "your-key" }
    }
  }
}

Windows note: If investgame-mcp is not found after pip install, ensure Python's Scripts directory is in your PATH. Run python -m investgame_mcp.server as a workaround.

Alternative: Use pipx install investgame-mcp — installs in an isolated environment and adds the command to PATH automatically. Install pipx first: pip install pipx && pipx ensurepath.

Other MCP Clients (remote — no install)

InvestGame is a hosted MCP server, so most clients connect over HTTP with nothing to install. Point the client at the connector URL and authorize in your browser — you paste your API key once on the InvestGame authorize page (get it from Get API Key). The URL is the same everywhere; only the config key differs per client:

https://app.investgame.net/mcp

OAuth support varies by client. If a client can't complete the browser authorization, use the local server method (see Prefer a local server? below).

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "investgame": { "url": "https://app.investgame.net/mcp" }
  }
}

Gemini CLI

~/.gemini/settings.json — use httpUrl for the streamable-HTTP transport:

{
  "mcpServers": {
    "investgame": { "httpUrl": "https://app.investgame.net/mcp" }
  }
}

OpenCode

opencode.json (project) or ~/.config/opencode/opencode.json (global) — type: "remote":

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "investgame": {
      "type": "remote",
      "url": "https://app.investgame.net/mcp",
      "enabled": true
    }
  }
}

Oh My Pi (omp)

~/.omp/agent/mcp.json (user) or .omp/mcp.json (project) — type: "http":

{
  "mcpServers": {
    "investgame": {
      "type": "http",
      "url": "https://app.investgame.net/mcp"
    }
  }
}

Pi agent

~/.pi/agent/mcp.json (global) or .pi/mcp.json (project) — type: "streamable-http":

{
  "mcpServers": {
    "investgame": {
      "type": "streamable-http",
      "url": "https://app.investgame.net/mcp"
    }
  }
}

Codex CLI

~/.codex/config.toml — a streamable-HTTP server entry:

[mcp_servers.investgame]
url = "https://app.investgame.net/mcp"

Note: Codex's streamable-HTTP + OAuth support is still maturing; if it won't authorize, use the local uvx method below.

Prefer a local server?

Any of these clients can also run the server locally over stdio. Install uvx (see Prerequisites) and use the same uvx investgame-mcp + INVESTGAME_API_KEY block shown under Local Installation (Claude Desktop / Claude Code) above, in that client's config format.

For analyst-grade answers, also install the companion skills: npx @investgame/skills install. They teach your assistant the InvestGame taxonomy and house formatting.

Get API Key

  1. Sign up at app.investgame.net
  2. Go to Profile → API Key → Generate
  3. Copy the key immediately (shown once)
  4. Set as INVESTGAME_API_KEY in your MCP config

Tools

InvestGame exposes two natural-language tools — ask a question in plain English and the server runs a multi-agent pipeline that returns structured JSON for your assistant to format.

Tool What it does
InvestGame_query Gaming M&A, fundraising, investor and company analytics from InvestGame's proprietary deal database — counts, rankings, precedent valuations and multiples, deal/company records, and taxonomy classification.
InvestGame_market_query Live public-market data (stock quote, market cap, financials) for listed companies — use for public-market questions instead of the deal pipeline.

Each tool returns one of two JSON shapes: {"mode":"clarify","questions":[...]} when the question is underspecified or out of scope (ask the user those questions, then re-call), or {"mode":"data","tables":[{name,columns,rows}],"entities":[{type,id,url}]} with the retrieved datasets and clickable deal/company links. The InvestGame taxonomy (sectors, platforms, genres, deal categories…) is resolved by the pipeline internally — no manual enum lookup needed.

Example Queries

Search & Detail:

  • "Find all VC firms investing in mobile gaming"
  • "Show me M&A deals over $100M in the last quarter"
  • "Get investment stats for Tencent"
  • "What are the recent IPOs in gaming?"

Stats & Analytics:

  • "How many gaming deals happened in 2025?"
  • "Average M&A deal size by year"
  • "Which country has the most gaming studios?"

Multiples & Comparison:

  • "What are typical EV/Revenue multiples for gaming M&A?"
  • "Compare mobile vs PC/console deal activity in 2024"
  • "Top 10 deals by revenue multiple"

Credits & Limits

Limit Value
Weekly credits 350
Monthly credits 1,200
Rate limit 30 requests/min
InvestGame_query 1 credit per unique deal or company surfaced in the answer
InvestGame_market_query 0.3× base — 1 credit per 3 queries (charged only on a match)
Repeat access Free (same entity = no charge)

When credits run out the server returns a 402 with a link to manage your account at app.investgame.net/profile.

Environment Variables

Variable Required Default
INVESTGAME_API_KEY Yes —
INVESTGAME_API_URL No https://app.investgame.net/api/v1

Changelog

0.7.2 (2026-06-02)

  • Docs: switch the Other MCP Clients section to the hosted HTTP remote connector (https://app.investgame.net/mcp, OAuth) — no local install for Cursor, Gemini CLI, OpenCode, Oh My Pi, Pi agent, Codex CLI. Fix the omp config path to ~/.omp/agent/mcp.json.
  • No tool behavior changes — docs-only release.

0.7.1 (2026-06-02)

  • Docs: add Other MCP Clients setup (Cursor, Gemini CLI, Codex CLI, OpenCode, Pi agent, Oh My Pi).
  • Docs: refresh Tools/Credits to the current two-tool surface (InvestGame_query, InvestGame_market_query); drop the obsolete 10-tool table and MCP Resources section.
  • No tool behavior changes — docs-only release.

0.7.0 (2026-05-31)

  • New InvestGame_market_query tool — answers public-market questions (stock quote, market cap, financials) for listed companies and returns structured JSON, skipping the InvestGame deal/M&A pipeline.
  • Billed at 0.3× the base credit cost (1 credit per 3 queries), charged only when data is returned.

0.5.4 (2026-04-12)

  • README: fix link formatting, add pipx alternative for Windows

0.5.3 (2026-04-12)

Claude Connectors integration — remote HTTP + OAuth:

  • Claude.ai one-click setup — connect via https://app.investgame.net/mcp in Settings → Connectors (no local install needed)
  • OAuth 2.0 + PKCE (S256) authorization flow with API key input
  • Per-request API key resolution — _resolve_client() uses OAuth token on remote HTTP, env var on local stdio
  • Both uvx investgame-mcp (local) and Claude Connectors (remote) work from the same codebase
  • README restructured: Claude.ai setup first, local install second

0.5.2 (2026-04-05)

Default output formatting hints + setup docs:

  • Server instructions now include ## Default Output — recommended format for each tool (table, card, metric summary)
  • Added 'top VC investors' to Common patterns (alongside existing PE, advisory, publisher patterns)
  • Updated Tools table in README (was showing 6 tools, now 10)
  • Added Prerequisites section with uv install commands for macOS, Linux, and Windows
  • Added Windows and Linux config file paths to Quick Start
  • Expanded Example Queries: added stats, multiples, and comparison examples
  • Added MCP Resources subsection documenting 15 investgame:// enum resources
  • Added Troubleshooting section with 5 common issues and solutions
  • Added Windows PATH note for pip install method
  • Fixed Python version in pip fallback note (was 3.10+, correct is 3.12+)
  • Fixed Credits table: search tools were listed as Free (actual cost since 0.4.0: 1 credit/item)

0.5.1 (2026-04-02)

Improved error diagnostics:

  • 5xx errors now include detail/message from JSON body (was generic "Try again later.")
  • ConnectError shows base_url + connection failure reason in logs
  • All error branches in _call_api_dict() log warning/error before raising ToolError
  • DRY: unified _extract_detail() helper for error detail extraction across all status codes
  • Safety: isinstance(val, str) guard prevents DRF dict/list values from leaking into messages
  • Error detail truncated to 300 chars (prevents HTML dump from Django DEBUG=True)

0.5.0 (2026-03-31)

  • 10 tools: search_companies, get_company, get_company_investment_stats, get_company_exits, get_company_stats, search_deals, get_deal, get_deal_stats, get_multiples_stats, compare_deal_segments
  • 15 resources: enum values for all filter fields
  • Smart date parsing (Q1 2024, H2 2025, YTD, last_quarter)
  • Credit tracking with _credits in every response
  • PII redaction (email, linkedin)

0.4.0 (2026-03-26)

  • Credit monetization: per-item charging, dedup (same entity = free), cache miss billing
  • x-credits-charged, x-credits-weekly-remaining, x-credits-monthly-remaining headers

0.3.0 (2026-03-24)

  • Server split: app.py, types.py, validators.py, resources.py
  • Security: follow_redirects=False, PII redaction, error truncation
  • 19 fixes from deep code review (PR #386)

0.2.1 (2026-03-22)

  • Hotfix: DEFAULT_API_URL pointed to old domain (arcadia.investgame.net → app.investgame.net)

0.2.0 (2026-03-18)

  • Initial PyPI release: 6 tools, 7 resources, 4 prompts

Troubleshooting

Problem Solution
uvx: command not found Install uv first — see Prerequisites
Invalid API key Check INVESTGAME_API_KEY in your MCP config. Keys are shown once — generate a new one at Profile → API Key
Credits exhausted Weekly (350) and monthly (1,200) limits reset automatically. Use stats tools (1 credit) instead of search to save credits
investgame-mcp: command not found (pip) Add Python Scripts to PATH, or use python -m investgame_mcp.server
Changes not taking effect Fully restart Claude Desktop (quit from system tray, not just close window)

Coming Soon

  • Anthropic Connectors Directory — official listing alongside FactSet, PitchBook, Morningstar
  • More tools — company charts, XLSX export
  • Smithery listing — one-click install from smithery.ai
  • MCP prompts — pre-built query templates for common use cases

License

Proprietary. InvestGame Ltd.

Metadata

Release files for investgame-mcp 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for investgame-mcp 0.8.0
File Size Uploaded Provenance Actions
investgame_mcp-0.8.0.tar.gz 213.8 kB Without provenance Details for investgame_mcp-0.8.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for investgame-mcp 0.8.0
File Interpreter ABI Platform Actions
investgame_mcp-0.8.0-py3-none-any.whl Python 3 none any Details for investgame_mcp-0.8.0-py3-none-any.whl

Total release size: 462.7 kB

Release files / investgame_mcp-0.8.0.tar.gz

Download URL investgame_mcp-0.8.0.tar.gz
Size 213.8 kB
Tags Source
SHA-256 checksum
How to use checksums
36274a8abc151411dff5857219fcfae0e98c41d04845d63c413e6fb399029d8c
BLAKE2b-256 checksum
How to use checksums
d3de40fbb2434fc8a347cb46c9bef235afaa0ec7f92695411c6077afca8a7edc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / investgame_mcp-0.8.0-py3-none-any.whl

Download URL investgame_mcp-0.8.0-py3-none-any.whl
Size 248.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3b54139f9df599e49bf810ccb476a9d955579445f8f4196c7686ec3fa42fef50
BLAKE2b-256 checksum
How to use checksums
677b173f91d09909b0953af61ebf29b29715eab3fa835bc725bb56e99de7b5d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Security for investgame-mcp 0.8.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page