# TXCIZ Model Context Protocol (MCP) Server

Endpoint: `POST https://www.cheats4you.com/mcp` | Server Card: `https://www.cheats4you.com/.well-known/mcp/server-card.json` | Official CLI: `https://www.cheats4you.com/cli`

The TXCIZ (Cheats4You) Model Context Protocol (MCP) server exposes five stateless, read-only tools, two prompt templates, four static resources, and three URI templates over Streamable HTTP JSON-RPC 2.0 (`2025-06-18` and `2025-03-26`) with zero API key setup.

## 1. Prerequisites, Available Read-Only Tools & Structured Schemas

Every TXCIZ MCP tool publishes both `inputSchema` and `outputSchema` and returns typed `structuredContent` alongside readable Markdown text over stateless Streamable HTTP JSON-RPC 2.0 (`2025-06-18` and `2025-03-26`).

| Tool Name | Input Arguments | Safety Annotations | Output |
| --- | --- | --- | --- |
| `list_products` | `status`, `query`, `controllerSupported`, `maxPriceEur` | `readOnlyHint: true` | Live Undetected/Updating status, delivery readiness, input support, and EUR plans across all 11 PC titles. |
| `get_product` | `productId` (required) | `readOnlyHint: true` | Complete product specification, EUR duration table, compatibility notes, videos, changelog, and setup steps. |
| `search_guides` | `slug`, `category`, `topic`, `query` | `readOnlyHint: true` | Filtered guide directory across all 49 articles or full tutorial Markdown. |
| `get_guide` | `slug` (required) | `readOnlyHint: true` | Full single-article Markdown, comparison tables, checklists, and FAQs. |
| `get_status` | `status` (optional) | `readOnlyHint: true` | Real-time Undetected, Updating, and Out of Stock counts plus per-title version and launcher readiness. |

### Prerequisites & Expected Verification Result

- **Host Prerequisites:** Any Streamable HTTP MCP host (`2025-06-18` or `2025-03-26`) such as Claude Desktop, Cursor, or Windsurf (plus Node.js `20+` if generating config via `txciz mcp-config --json`). Zero API key required.
- **Expected Output:** Sending `initialize` negotiates `protocolVersion: "2025-06-18"`; `tools/list` returns 5 tools (`readOnlyHint: true`); and `tools/call` returns `content` text plus validated `structuredContent` within the shared `120 req/60s` window.

## 2. MCP Protocol Negotiation, Resources & URI Templates

The TXCIZ Model Context Protocol server operates at `POST https://www.cheats4you.com/mcp` and publishes machine metadata at `GET /.well-known/mcp/server-card.json`. For headless scripting without JSON-RPC, poll [REST v1 Status Endpoint](/api/v1/status) or download [txciz-cli.tgz npm package](/cli/txciz-cli.tgz), standalone [txciz.mjs ESM script](/cli/txciz.mjs), or the complete [TXCIZ CLI Markdown specification](/cli.md).

In addition to `tools/list` and `tools/call`, the server implements `resources/list`, `resources/templates/list`, `resources/read`, `prompts/list`, and `prompts/get` (`compare_game_plans` and `recommend_game_setup`):

| Resource URI / Template | Method | Media Type | Returned Content |
| --- | --- | --- | --- |
| `mcp://server-card.json` | `resources/read` | `application/json` | Declarative server card listing protocol versions, capabilities, prompts, and tool schemas. |
| `txciz://status` | `resources/read` | `application/json` | Live Undetected, Updating, and Out of Stock snapshot parity with `GET /api/v1/status`. |
| `txciz://products/{productId}` | `resources/templates/list` | `text/markdown` | Complete product specification, EUR pricing table, PC hardware requirements, and FAQs. |
| `txciz://shards/{productId}` | `resources/templates/list` | `text/markdown` | Token-capped single-game RAG shard (<8,000 tokens) combining specs and all guides. |
| `txciz://guides/{slug}` | `resources/templates/list` | `text/markdown` | Complete original guide prose, parameter tables, checklists, and structured FAQs. |
| `https://www.cheats4you.com/llms.txt` | `resources/read` | `text/plain` | Concise LLM index documenting product slugs, token estimates, and guide hierarchy. |
| `https://www.cheats4you.com/openapi.json` | `resources/read` | `application/openapi+json` | Full OpenAPI 3.1.0 schema covering every REST v1, status, catalog, and guide route. |

## 3. Client Configuration, Host Gotchas & Sample JSON-RPC Output

Connect compatible AI assistants directly to `https://www.cheats4you.com/mcp` without installing a local stdio server process or managing credentials. Generate the base config anytime with `txciz mcp-config --json` via [TXCIZ CLI](/cli):

```json
{
  "mcpServers": {
    "txciz": {
      "type": "http",
      "url": "https://www.cheats4you.com/mcp"
    }
  }
}
```

### MCP Client Config & Gotcha Table (Claude Desktop, Cursor, Windsurf)

IDE clients differ in the JSON field name required for remote Streamable HTTP MCP endpoints. Windsurf requires `"serverUrl"` whereas Claude Desktop and Cursor require `"url"`:

| MCP Host | Config File Path | Required URL Key | Common Configuration Gotcha |
| --- | --- | --- | --- |
| **Claude Desktop** | `%APPDATA%\Claude\claude_desktop_config.json` / `~/Library/Application Support/Claude/claude_desktop_config.json` | `"url": "https://www.cheats4you.com/mcp"` | Fully quit the system-tray process after saving JSON; trailing commas cause silent parse failures. |
| **Cursor** | `~/.cursor/mcp.json` or `.cursor/mcp.json` | `"url": "https://www.cheats4you.com/mcp"` + `"type": "http"` | Omit `command`/`args` for remote Streamable HTTP; verify schema with `txciz mcp-config --json`. |
| **Windsurf** | `%USERPROFILE%\.codeium\windsurf\mcp_config.json` | `"serverUrl": "https://www.cheats4you.com/mcp"` (**required!**) | **Using `"url"` silently drops all 5 TXCIZ tools in Windsurf** — rename the key to `"serverUrl"`. |

### Sample JSON-RPC initialize & tools/call Output

```json
// 1. POST /mcp initialize response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": {
      "tools": {
        "listChanged": false
      },
      "resources": {
        "subscribe": false
      },
      "prompts": {
        "listChanged": false
      }
    },
    "serverInfo": {
      "name": "txciz-storefront-mcp",
      "version": "2.1.0"
    }
  }
}

// 2. POST /mcp tools/call (get_status) snippet
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# TXCIZ Live Catalog Status (Verified 2026-11-18)..."
      }
    ],
    "structuredContent": {
      "updatedAt": "2026-11-18",
      "summary": {
        "totalCount": 11,
        "undetectedCount": 10,
        "updatingCount": 1,
        "outOfStockCount": 0,
        "comingSoonCount": 0
      }
    },
    "isError": false
  }
}
```

## 4. Error Troubleshooting, Security Boundaries & Setup Guides

The TXCIZ Model Context Protocol server enforces a strict read-only security perimeter: tools inspect public catalog specifications, live statuses, binary stock flags, EUR plans, and the 49 published guides without ever exposing customer Stripe sessions, receipts, Backup Codes, or License Keys. Pair `get_status` with `resources/read` on `txciz://shards/{productId}` for `<8,000`-token single-game context loading, and combine [TXCIZ API Docs](/docs), [TXCIZ CLI](/cli), and [Live Status Board](/status) within `120 req/60s`.

### MCP Error & Transport Troubleshooting Table (-32700, -32601, -32602, 405)

| Error Code / HTTP | Meaning | Common Trigger | Resolution |
| --- | --- | --- | --- |
| `-32700` | Parse error | Malformed JSON payload or trailing comma in `POST /mcp` body. | Validate UTF-8 JSON syntax and send `Content-Type: application/json`. |
| `-32601` | Method not found | Unsupported RPC method name outside MCP `2025-06-18` spec. | Call `initialize`, `tools/list`, `tools/call`, `resources/list`, `resources/templates/list`, `resources/read`, `prompts/list`, or `prompts/get`. |
| `-32602` | Invalid params | Unknown tool name, non-string `productId`, or missing required `slug`. | Check exact argument names in `tools/list` (`productId: "rob-run"`, valid guide `slug`). |
| `HTTP 405` | Method Not Allowed | Sending `GET /mcp` for SSE stream or `DELETE /mcp` without `Accept: application/json`. | Send `POST /mcp` for JSON-RPC calls, or `GET /mcp` with `Accept: application/json` for server-card metadata. |
| `HTTP 429` | Too Many Requests | Client exceeded `120` requests per `60s` sliding window. | Honor the numeric `Retry-After` header and cache static `tools/list` / shard responses. |

### Loader Diagnostics, Onboarding & Guide Links

- **Setup & Loader Diagnostics:** Link buyers to the [6-Step PC Setup Guide](/setup) or resolve `0x00000001`, `MsSo64.sys`, and Core Isolation issues via [Loader Security & Error Fixes](/blog/txciz-loader-setup-security-errors-guide) (or query `get_guide` with `slug: "txciz-loader-setup-security-errors-guide"`).
- **Full 49-Article Knowledge Base:** Explore all game-specific ESP, 2D radar, and aimbot guides at [TXCIZ Blog & Guides](/blog).

## Frequently Asked Questions

### Which MCP protocol versions does the TXCIZ server negotiate?

The server negotiates protocolVersion 2025-06-18 by default (including forward-compatible requests such as 2025-11-25) and echoes 2025-03-26 whenever a client initializes or sends MCP-Protocol-Version: 2025-03-26.

### Do all five TXCIZ MCP tools return structured JSON alongside Markdown text?

Yes. All five tools (list_products, get_product, search_guides, get_guide, and get_status) publish an outputSchema in tools/list and return both content text blocks and typed structuredContent payloads in tools/call.

### Which MCP resources, URI templates, and prompts are available?

Call resources/list and resources/templates/list for mcp://server-card.json, txciz://status, txciz://products/{productId}, txciz://shards/{productId}, and txciz://guides/{slug}, or call prompts/list for compare_game_plans and recommend_game_setup. Generate client JSON anytime with npx --yes https://www.cheats4you.com/cli/txciz-cli.tgz mcp-config --json.

### Why does Windsurf require serverUrl instead of url in MCP config JSON?

Windsurf mcp_config.json requires "serverUrl": "https://www.cheats4you.com/mcp" for remote Streamable HTTP servers, whereas Claude Desktop and Cursor use "url". Using "url" inside Windsurf silently hides all 5 TXCIZ tools.
