Model Context Protocol (MCP)
Add the JustTCG MCP server to your favorite coding agents with a single command. Supports Claude Code, Cursor, OpenCode, VSCode, and more.
Install the MCP Server
You can connect the JustTCG MCP server effortlessly using the newly adopted add-mcp CLI tool. This automates the configuration for various LLMs and IDEs across both Project-level and Global scopes.
Basic Installation
npx add-mcp https://mcp.justtcg.com --header "x-api-key: YOUR_API_KEY"Usage Examples
The add-mcp command supports a multitude of environments and interactive modes. Here are some of the most common applications tailored for JustTCG and other MCP tooling boundaries:
# Remote MCP server (streamable HTTP)
npx add-mcp https://mcp.justtcg.com
# Remote MCP server with API Key Auth Header
npx add-mcp https://mcp.justtcg.com --header "x-api-key: YOUR_API_KEY"
# Non-interactive installation to all detected agents in the project directory
npx add-mcp https://mcp.justtcg.com -y
# Non-interactive installation to the global Claude Code config
npx add-mcp https://mcp.justtcg.com -g -a claude-code -y
# Install tailored for Cursor and Claude Code specifically
npx add-mcp https://mcp.justtcg.com -a cursor -a claude-code
# Install with custom server name reference
npx add-mcp https://mcp.justtcg.com --name justtcg-prod
# Add generated config files to your local .gitignore
npx add-mcp https://mcp.justtcg.com -a cursor -y --gitignoreCLI Options
Configure the deployment scope, agent filtering, and headers using explicit options.
| Option | Description |
|---|---|
| -g, --global | Install to user directory instead of project |
| -a, --agent <agent> | Target specific agents (e.g., cursor, claude-code). Can be repeated. |
| -t, --transport <type> | Transport type for remote servers: http (default), sse |
| --type <type> | Alias for --transport |
| --header <header> | HTTP header for remote servers (repeatable, Key: Value) |
| -n, --name <name> | Server name (auto-inferred if not provided) |
| -y, --yes | Skip all confirmation prompts |
| --all | Install to all agents |
| --gitignore | Add generated config files to .gitignore |
Transport Layers & Headers
add-mcp supports streamable HTTP, SSE (Server-Sent Events), and generic stdio for local servers. By default, JustTCG runs over streamable HTTP. If needed, explicitly apply --transport sse.
HTTP Headers
Use the --header argument to pass custom headers for remote endpoints. The flag can be infinitely repeated for multiple keys. Header support is thoroughly available for remote installs acting against our MCP specification.
npx add-mcp https://mcp.justtcg.com --header "x-api-key: YOUR_JUSTTCG_API_KEY"Supported Agents
The deployment CLI uses smart detection to auto-discover IDEs traversing your current Project Directory and Global Config paths.
| Agent | --agent Key | Project Path | Global Path |
|---|---|---|---|
| Claude Code | claude-code | .mcp.json | ~/.claude.json |
| Claude Desktop | claude-desktop | - | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | cursor | .cursor/mcp.json | ~/.cursor/mcp.json |
| VS Code | vscode | .vscode/mcp.json | ~/Library/Application Support/Code/User/mcp.json |
| OpenCode | opencode | opencode.json | ~/.config/opencode/opencode.json |
| Gemini CLI | gemini-cli | .gemini/settings.json | ~/.gemini/settings.json |
Troubleshooting
Server Not Loading
- Verify the JustTCG server URL is correctly specified (
https://mcp.justtcg.com/mcp). - Check your agent's explicit MCP configuration JSON validation syntax for unescaped characters.
- In VS Code or Cursor, double down on confirming whether the transport layer supports raw HTTP stream handling natively.