Official MCP quickstart

Create a focus space from an agent in minutes.

DeepPane's production-supported stdio MCP path lets an agent create a playable focus page or read a user-authorized work-time summary without receiving media files, raw history rows, or full account tokens.

Open Dashboard Agent Access Read Agent docs Read llms.txt

Five-minute path

Run server, mint token, call tool, hand off result.

Use Dashboard consent for user powers. Use an Agent Key for real production integrations that need attribution, bounded quota, and provenance.

1. Run the server

Start the first-party stdio server from your MCP host or local integration workspace.

2. Mint a scoped token

Ask the user to open Dashboard Agent Access and create a focus-space or history-summary handoff token.

3. Call the tool

Pass only the short-lived handoffToken argument into the matching MCP tool.

4. Return the outcome

Give the user the short DeepPane URL and PNG QR code. Keep media selection inside DeepPane.

Start server

Official stdio command

DEEPPANE_API_BASE_URL=https://deeppane.com node apps/mcp-server/server.js

For production integrations, set DEEPPANE_AGENT_KEY in the host environment instead of pasting an agent key into chat-visible arguments.

Tools

Only four tools are exposed.

deeppane.create_focus_space
deeppane.request_focus_space_create_token
deeppane.request_history_summary_token
deeppane.read_history_summary

Tool input

Bounded intent, not catalog queries.

{
  "handoffToken": "dpa.focus-space-create...",
  "intent": "writing",
  "locale": "en",
  "timer": { "focusMinutes": 35, "breakMinutes": 5 },
  "sceneHints": { "environment": ["forest"], "mood": ["evening"] },
  "musicHints": { "style": ["piano"], "vocalProfile": "none" }
}

Tool result

Return URL and PNG QR.

{
  "shareUrl": "https://deeppane.com/s/abc123XYZ",
  "shortShareUrl": "https://deeppane.com/s/abc123XYZ",
  "qrCodeUrl": "https://deeppane.com/s/abc123XYZ/qr.png",
  "qrCodePngUrl": "https://deeppane.com/s/abc123XYZ/qr.png",
  "qrCodeSvgUrl": "https://deeppane.com/s/abc123XYZ/qr.svg",
  "policy": {
    "customTimerAllowed": true,
    "rawMediaAccess": false,
    "bulkMediaAccess": false
  }
}

Boundary

Agent-friendly does not mean catalog-open.

MCP callers can create outcomes and read compact user-authorized summaries. They cannot list scenes, list music, download media, fetch signed media URLs, export tag graphs, or read raw focus events.

Mint Dashboard token Request Agent Key Install plugin