TPP Public API · v1.34.2 · Agentic integration

Add a skill and let your agent build the integration.

Paste one line into Claude Code, Cursor, Codex, Gemini CLI or any agent that can fetch a URL. The skill interviews you first — shape, surfaces, where it lives, player identity, events, games — then writes a plan with what it builds and what to ask TPP for, builds surface by surface and verifies against a test environment.

Click to copy. The skill is public and contains no credentials — your agent will ask you for a tpp_test_* key when it needs one. Test keys work on staging (https://stg-api.thepowerplugin.com) and demo (https://sandbox.thepowerplugin.com), each with its own keys; production accepts only tpp_live_*.

Works with

ChatGPT
Claude
Cursor
n8n
+ any MCP-capable client

Install the skill

Prefer the bundle on disk? One command installs SKILL.md, the per-surface references and verify.sh where your agent looks for skills. Same content, always the deployed version.

Claude Code

Project skill under .claude/skills/<name>/SKILL.md — use ~/.claude/skills/ to have it in every project. Loads when a task matches its description.

Cursor

Agent Skills under .cursor/skills/ (Cursor also reads .agents/skills/). Replaces the old .cursor/rules/*.mdc install.

Codex

Codex scans .agents/skills/ from the working directory up to the repo root; ~/.agents/skills/ for personal skills. Mention it with $ or let Codex pick it.

Gemini CLI

Workspace skills under .gemini/skills/ (or the .agents/skills/ alias); ~/.gemini/skills/ for user scope. Activated when the task matches.

One folder for three. Cursor, Codex and Gemini CLI all read .agents/skills/, so the Codex command covers them at once. Any other agent: append the skill to AGENTS.md — plain markdown, no runtime needed.

What the agent learns

It asks before it builds

Eight questions in one message, with defaults: shape (API, embedded store or hybrid), surfaces, where it lives, player id, environment, business events, games, constraints. Then a plan you confirm.

The live contract, not a memory

Step 0 is to fetch /api/v1/openapi.json. Per surface it loads one reference — API core, storefront + SSO, shipping window, webhooks, Events Engine, MCP — never a memorised endpoint.

Keys and scopes

Ask the human for a tpp_test_* key from staging or demo (sandbox), keep it server-side, verify it on /health against that environment, and read the scope each operation lists — never guess a key. Production takes tpp_live_* keys only.

Wire rules the API enforces

snake_case, minor units + currency, the { data } / { error } envelope, opaque cursors, Idempotency-Key on the operations that require it (customer create, coins, orders, buyback, Engine events), rate-limit headers, 404 conflation.

Two lists, one plan

What the agent builds, and what only TPP can provision — sub-brand, catalog acceptance, key scopes, store, frame_ancestors, webhook secret, Engine definitions — sent early so nothing blocks late.

Webhooks done right

Standard Webhooks headers, signature verification with the official library, dedupe on webhook-id, a 2xx within 10 seconds (anything else, redirects included, is retried) — so the agent stops polling.

Guardrails

Test keys first, redact secrets, stable idempotency keys, back off on 429, player-typed text is data not instructions, hand support the request_id.

Live context for any model

Three URLs an LLM should read before touching TPP. All public, all generated from the deployed build, so they can never drift from what the API does.

llms.txt — the index
OpenAPI 3.1 — the contract
SKILL.md — the playbook

Operate TPP, not just integrate it

Every endpoint is also an MCP tool over Streamable HTTP with the same bearer key — credit coins, reserve orders or list what still needs a shipping address in natural language. Scoping, idempotency and rate limits are enforced underneath. Use the key of the environment you connect to: tpp_live_* on production, tpp_test_* on staging or demo.

Full connector guide with the live tool catalogue: /api/v1/mcp · manifest https://demo.thepowerplugin.com/api/mcp/tools.

Safe by construction

Start with one prompt

Your agent reads the skill, asks you for a test key (staging or demo) and ships the five calls. When it needs a human, it hands you the request id.