investgame-mcp 0.5.2

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.

Prerequisites

The recommended setup uses uvx — a command from the uv Python package manager. Install it first if you don't have it:

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.

Quick Start (recommended)

Add to your Claude Desktop config:

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

{
  "mcpServers": {
    "investgame": {
      "command": "uvx",
      "args": ["investgame-mcp"],
      "env": {
        "INVESTGAME_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop. Done — 10 tools available.

All Installation Methods

1. uvx (recommended, no install needed)

{
  "mcpServers": {
    "investgame": {
      "command": "uvx",
      "args": ["investgame-mcp"],
      "env": { "INVESTGAME_API_KEY": "your-key" }
    }
  }
}

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.

3. Claude Code (.mcp.json in project root)

{
  "mcpServers": {
    "investgame": {
      "command": "uvx",
      "args": ["investgame-mcp"],
      "env": { "INVESTGAME_API_KEY": "your-key" }
    }
  }
}

4. From source

git clone https://github.com/InvestGameLtd/Arcadia.git
cd Arcadia
INVESTGAME_API_KEY=your-key python -m investgame_mcp.server

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

Tool	Credits	What it does
search_companies	1/item	Search and filter companies by name, type, sector, region, platform, features
get_company	1	Full company profile: sector, platforms, deals, metrics, contacts, LinkedIn
get_company_investment_stats	1	Investment analytics: activity, focus, portfolio exits (VC/PE/Strategic)
get_company_exits	1	Portfolio exit details — M&A and IPO deals
get_company_stats	1	Aggregate company counts with optional group_by (e.g., by country)
search_deals	1/item	Search deals by type, period, sector, size range, company
get_deal	1	Full deal details: ~50 fields including participants, terms, financials
get_deal_stats	1	Aggregate deal statistics: count, total value, average, median
get_multiples_stats	1	Valuation multiples (EV/Revenue, EV/EBITDA) with top deals breakdown
compare_deal_segments	2	Side-by-side comparison of two deal segments (e.g., mobile vs PC/console)

MCP Resources

15 read-only resources with investgame:// URIs provide valid filter values for all enum parameters (company types, deal categories, platforms, genres, sectors, etc.). Claude reads these automatically before making tool calls — no manual 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
Search tools	1 credit per unique item returned
Stats tools	1 credit flat
Detail tools	1 credit each
Segment comparison	2 credits
Repeat access	Free (same entity = no charge)

Credit balance is included in every response (_credits field).

Environment Variables

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

Changelog

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

• Remote server — connect via URL without local install ("url": "https://...")
• More tools — market data, 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.