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/getting-started/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.
• If tools are still missing, tell them: "Please double-check that the MCP is connected; you can do this in Settings → Connections."
• If they confirm MCP is already connected and tools are still missing, this chat started before the connection, so the tools are not in this conversation. Tell them to start a new chat and paste this prompt:

Deck MCP is connected. Create and run Build Projects. Follow https://docs.getdeck.io/docs/agents/getting-started/prompts/projects.md

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.