investgame-mcp 0.8.0

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

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.

🟠 Claude.ai — One-Click Setup (recommended)

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

1. uvx (recommended, no install needed)

{
  "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.