techzone-mcp

MCP server for IBM Technology Zone: manage your reservations end-to-end and search the TechZone catalog from Claude. Every state-changing tool describes itself as such so Claude confirms with you before calling; cancellation additionally requires echoing the reservation's exact name.

Tools

Plus two resources: techzone://reservations (live reservation summary) and techzone://reservation/{id} (full detail for one reservation).

Related MCP server: IBM Cloud MCP Server

Setup

1. Get your API token: techzone.ibm.com → My Profile → API token.

2. Install and register with Claude Code:

uv sync
claude mcp add techzone --env TECHZONE_API_TOKEN=<your-token> -- uv --directory /path/to/techzone-mcp run techzone-mcp

(Or put TECHZONE_API_TOKEN=<your-token> in a .env file in this directory — it is gitignored.)

TechZone tokens expire periodically; when the server reports a 401, grab a fresh token from My Profile.

Development

uv sync
uv run pytest                  # unit tests (mocked, no live API)
uv run python walkthrough.py   # interactive live walkthrough of every tool

The walkthrough steps through all 11 tools against the real API: read-only steps run on Enter, write steps are skipped unless you type yes, and sensitive service-link values are redacted from output.

API endpoints are undocumented publicly; they were derived from the open-source itzcli and verified live. See PLAN.md for design notes.