Deck Docs

Projects agent protocol

MCP-first instructions for listing and mutating Build Projects.

This page is the agent-readable protocol for Deck projects. Humans can follow along. Coding agents should treat the protocol section as the source of truth and probe Deck MCP before sending anyone to signup.

Deck projects — agent protocol

Work MCP-first. Probe Deck MCP in this session before you send anyone to signup.

1. Probe MCP

Call a cheap Deck MCP tool (get_user_context or get_overview). This must be a real tool call.

401 Unauthorized

The human is not connected in this client. Tell them to Connect MCP here (Cursor, Claude, or ChatGPT). Do not open signup. Do not mint or ask for a dk_ API key.

No Deck tools available

Deck MCP is not installed. Fetch and follow the AI PM protocol at:

https://docs.getdeck.io/docs/agents/prompts/ai-pm.md

Do not invent another setup URL. Do not send them to signup from this prompt.

After they return, probe MCP again. If tools exist, continue below.

2. After MCP works

Use list_projects to see Build Projects. Use explore_build_projects to read one. Use mutate_project_build to change a project. Never create dk_ keys.