{
  "schemaVersion": 1,
  "title": "Chumbo recipes",
  "description": "Task-oriented recipes for builders and their coding agents.",
  "recipes": [
    {
      "slug": "first-supabase-mcp",
      "title": "Add an MCP server to an existing Supabase app with Chumbo",
      "description": "Take an existing Supabase application from a generated MCP function to one useful capability you can discover and call.",
      "topics": [
        "get-started"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/first-supabase-mcp/",
      "markdown": "https://chumbo.dev/recipes/first-supabase-mcp/recipe.md",
      "json": "https://chumbo.dev/recipes/first-supabase-mcp/recipe.json"
    },
    {
      "slug": "choose-mcp-auth",
      "title": "Choose OAuth, bearer, API-key or public auth for a Supabase MCP",
      "description": "Choose the Chumbo access mode that fits your callers, with a clear account of which identity reaches your Supabase data.",
      "topics": [
        "get-started",
        "connect-users"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/choose-mcp-auth/",
      "markdown": "https://chumbo.dev/recipes/choose-mcp-auth/recipe.md",
      "json": "https://chumbo.dev/recipes/choose-mcp-auth/recipe.json"
    },
    {
      "slug": "build-mcp-with-coding-agent",
      "title": "Build a Supabase MCP with a coding agent and the Chumbo skill",
      "description": "Install project-local Chumbo guidance, preview setup changes and give a coding agent a bounded application task it can verify.",
      "topics": [
        "get-started",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/build-mcp-with-coding-agent/",
      "markdown": "https://chumbo.dev/recipes/build-mcp-with-coding-agent/recipe.md",
      "json": "https://chumbo.dev/recipes/build-mcp-with-coding-agent/recipe.json"
    },
    {
      "slug": "oauth-user-connections",
      "title": "Connect AI agents to Supabase users with OAuth and Chumbo",
      "description": "Give users a sign-in and consent path to your Supabase MCP, then verify the account and permissions behind a real tool call.",
      "topics": [
        "connect-users"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/oauth-user-connections/",
      "markdown": "https://chumbo.dev/recipes/oauth-user-connections/recipe.md",
      "json": "https://chumbo.dev/recipes/oauth-user-connections/recipe.json"
    },
    {
      "slug": "design-useful-mcp-tools",
      "title": "Design useful MCP tools for a Supabase application with Chumbo",
      "description": "Turn an existing product operation into a narrow MCP tool with clear inputs, caller-owned access and a result the agent can use.",
      "topics": [
        "get-started",
        "design-results"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "contract-tested",
        "check": "rls-projects",
        "packageVersion": "0.11.3",
        "checkedOn": "2026-09-18",
        "walkthroughVerified": false,
        "note": "The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run.",
        "versionPolicy": "Example checked with Chumbo 0.11.3 on 2026-09-18 (UTC). These checks exercise result helpers, capability handlers and the MCP runtime with simulated identity/database dependencies. They do not prove your application’s real auth, RLS or deployment. Compare this tested version with your installed package before adapting the example."
      },
      "html": "https://chumbo.dev/recipes/design-useful-mcp-tools/",
      "markdown": "https://chumbo.dev/recipes/design-useful-mcp-tools/recipe.md",
      "json": "https://chumbo.dev/recipes/design-useful-mcp-tools/recipe.json"
    },
    {
      "slug": "supabase-rls-mcp",
      "title": "Build a Supabase MCP server with your existing RLS policies",
      "description": "Let your users’ agents work with their projects. Chumbo connects the MCP layer to Supabase Auth, so your existing row-level security stays in charge.",
      "topics": [
        "connect-users",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "contract-tested",
        "check": "rls-projects",
        "packageVersion": "0.11.3",
        "checkedOn": "2026-09-18",
        "walkthroughVerified": false,
        "note": "Example typechecked and exercised with simulated query results. Run the two-user checks below against your own Supabase app; these checks do not prove your RLS policies.",
        "versionPolicy": "Example checked with Chumbo 0.11.3 on 2026-09-18 (UTC). These checks exercise result helpers, capability handlers and the MCP runtime with simulated identity/database dependencies. They do not prove your application’s real auth, RLS or deployment. Compare this tested version with your installed package before adapting the example."
      },
      "html": "https://chumbo.dev/recipes/supabase-rls-mcp/",
      "markdown": "https://chumbo.dev/recipes/supabase-rls-mcp/recipe.md",
      "json": "https://chumbo.dev/recipes/supabase-rls-mcp/recipe.json"
    },
    {
      "slug": "mcp-result-contracts",
      "title": "Choose text, structured data and error results for Chumbo MCP tools",
      "description": "Design readable MCP answers and typed result contracts without dumping database rows or duplicating JSON into text.",
      "topics": [
        "design-results"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "contract-tested",
        "check": "task-results",
        "packageVersion": "0.11.3",
        "checkedOn": "2026-09-18",
        "walkthroughVerified": false,
        "note": "The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run.",
        "versionPolicy": "Example checked with Chumbo 0.11.3 on 2026-09-18 (UTC). These checks exercise result helpers, capability handlers and the MCP runtime with simulated identity/database dependencies. They do not prove your application’s real auth, RLS or deployment. Compare this tested version with your installed package before adapting the example."
      },
      "html": "https://chumbo.dev/recipes/mcp-result-contracts/",
      "markdown": "https://chumbo.dev/recipes/mcp-result-contracts/recipe.md",
      "json": "https://chumbo.dev/recipes/mcp-result-contracts/recipe.json"
    },
    {
      "slug": "compact-project-results",
      "title": "Paginate Supabase MCP tool results with Chumbo",
      "description": "Return compact project pages from your Supabase MCP, with bounded results, stable cursors, and a clear next call for agents and typed clients.",
      "topics": [
        "design-results",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "contract-tested",
        "check": "compact-projects",
        "packageVersion": "0.11.3",
        "checkedOn": "2026-09-18",
        "walkthroughVerified": false,
        "note": "Exact example typechecked and exercised with simulated query results. Verify real auth, RLS, and pagination with your application’s fixtures.",
        "versionPolicy": "Example checked with Chumbo 0.11.3 on 2026-09-18 (UTC). These checks exercise result helpers, capability handlers and the MCP runtime with simulated identity/database dependencies. They do not prove your application’s real auth, RLS or deployment. Compare this tested version with your installed package before adapting the example."
      },
      "html": "https://chumbo.dev/recipes/compact-project-results/",
      "markdown": "https://chumbo.dev/recipes/compact-project-results/recipe.md",
      "json": "https://chumbo.dev/recipes/compact-project-results/recipe.json"
    },
    {
      "slug": "resources-and-prompts",
      "title": "Add MCP Resources, prompts and usage instructions to a Supabase Chumbo server",
      "description": "Add discoverable usage guidance, a readable Resource and a workflow prompt to your MCP without putting a full document in every tool result.",
      "topics": [
        "design-results"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "contract-tested",
        "check": "resources-prompts",
        "packageVersion": "0.11.3",
        "checkedOn": "2026-09-18",
        "walkthroughVerified": false,
        "note": "The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run.",
        "versionPolicy": "Example checked with Chumbo 0.11.3 on 2026-09-18 (UTC). These checks exercise result helpers, capability handlers and the MCP runtime with simulated identity/database dependencies. They do not prove your application’s real auth, RLS or deployment. Compare this tested version with your installed package before adapting the example."
      },
      "html": "https://chumbo.dev/recipes/resources-and-prompts/",
      "markdown": "https://chumbo.dev/recipes/resources-and-prompts/recipe.md",
      "json": "https://chumbo.dev/recipes/resources-and-prompts/recipe.json"
    },
    {
      "slug": "mutation-receipts",
      "title": "Return safe mutation receipts from Supabase MCP tools with Chumbo",
      "description": "Wrap an existing application write in a narrow MCP tool and return a compact receipt with the resulting state and next step.",
      "topics": [
        "design-results",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "contract-tested",
        "check": "mutation-receipt",
        "packageVersion": "0.11.3",
        "checkedOn": "2026-09-18",
        "walkthroughVerified": false,
        "note": "The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run.",
        "versionPolicy": "Example checked with Chumbo 0.11.3 on 2026-09-18 (UTC). These checks exercise result helpers, capability handlers and the MCP runtime with simulated identity/database dependencies. They do not prove your application’s real auth, RLS or deployment. Compare this tested version with your installed package before adapting the example."
      },
      "html": "https://chumbo.dev/recipes/mutation-receipts/",
      "markdown": "https://chumbo.dev/recipes/mutation-receipts/recipe.md",
      "json": "https://chumbo.dev/recipes/mutation-receipts/recipe.json"
    },
    {
      "slug": "scoped-mcp-capabilities",
      "title": "Gate Supabase MCP tools by scopes and application API keys with Chumbo",
      "description": "Serve different capability sets from one MCP using application-resolved scopes, with authorization on discovery and direct calls.",
      "topics": [
        "connect-users",
        "advanced-patterns"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/scoped-mcp-capabilities/",
      "markdown": "https://chumbo.dev/recipes/scoped-mcp-capabilities/recipe.md",
      "json": "https://chumbo.dev/recipes/scoped-mcp-capabilities/recipe.json"
    },
    {
      "slug": "test-mcp-capabilities",
      "title": "Test Supabase MCP tools and scoped discovery with chumbo/testing",
      "description": "Exercise the Chumbo MCP boundary with controlled dependencies, then keep real Supabase authentication and RLS checks as a separate integration layer.",
      "topics": [
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "contract-tested",
        "check": "protocol-test",
        "packageVersion": "0.11.3",
        "checkedOn": "2026-09-18",
        "walkthroughVerified": false,
        "note": "The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run.",
        "versionPolicy": "Example checked with Chumbo 0.11.3 on 2026-09-18 (UTC). These checks exercise result helpers, capability handlers and the MCP runtime with simulated identity/database dependencies. They do not prove your application’s real auth, RLS or deployment. Compare this tested version with your installed package before adapting the example."
      },
      "html": "https://chumbo.dev/recipes/test-mcp-capabilities/",
      "markdown": "https://chumbo.dev/recipes/test-mcp-capabilities/recipe.md",
      "json": "https://chumbo.dev/recipes/test-mcp-capabilities/recipe.json"
    },
    {
      "slug": "deploy-debug-mcp",
      "title": "Test, deploy and debug a Chumbo MCP on Supabase Edge Functions",
      "description": "Move from local checks to an actual MCP call, diagnose the failing boundary and verify the deployed endpoint your users will connect to.",
      "topics": [
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/deploy-debug-mcp/",
      "markdown": "https://chumbo.dev/recipes/deploy-debug-mcp/recipe.md",
      "json": "https://chumbo.dev/recipes/deploy-debug-mcp/recipe.json"
    },
    {
      "slug": "clean-mcp-url",
      "title": "Use a custom domain or Next.js route for a Supabase Chumbo MCP",
      "description": "Expose your existing MCP at a product-facing URL while preserving the function route, OAuth metadata and request behavior.",
      "topics": [
        "connect-users",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/clean-mcp-url/",
      "markdown": "https://chumbo.dev/recipes/clean-mcp-url/recipe.md",
      "json": "https://chumbo.dev/recipes/clean-mcp-url/recipe.json"
    },
    {
      "slug": "many-mcps-one-function",
      "title": "Serve multiple MCP servers from one Supabase Edge Function",
      "description": "Resolve a named MCP from the request path, give each surface its own instructions and capabilities, and keep one deployable Supabase Edge Function.",
      "topics": [
        "advanced-patterns",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/many-mcps-one-function/",
      "markdown": "https://chumbo.dev/recipes/many-mcps-one-function/recipe.md",
      "json": "https://chumbo.dev/recipes/many-mcps-one-function/recipe.json"
    },
    {
      "slug": "durable-mcp-state",
      "title": "Add credential-partitioned durable state to a Supabase MCP",
      "description": "Use Chumbo's bounded credential-partitioned state for read-before-write receipts while application RLS and resource versions remain authoritative.",
      "topics": [
        "advanced-patterns",
        "connect-users",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/durable-mcp-state/",
      "markdown": "https://chumbo.dev/recipes/durable-mcp-state/recipe.md",
      "json": "https://chumbo.dev/recipes/durable-mcp-state/recipe.json"
    },
    {
      "slug": "observe-mcp-runs",
      "title": "Add lifecycle observability and run correlation to a Chumbo MCP",
      "description": "Record redacted capability lifecycle facts, capture the advertised tool surface, and join selected calls into an explicit application run.",
      "topics": [
        "advanced-patterns",
        "test-and-ship"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/observe-mcp-runs/",
      "markdown": "https://chumbo.dev/recipes/observe-mcp-runs/recipe.md",
      "json": "https://chumbo.dev/recipes/observe-mcp-runs/recipe.json"
    },
    {
      "slug": "mcp-apps-supabase",
      "title": "Build an authenticated MCP App on Supabase with Chumbo",
      "description": "Serve a bundled interactive MCP App through one Supabase Edge Function while host-mediated tools preserve the caller's auth, scopes, and RLS boundary.",
      "topics": [
        "advanced-patterns",
        "design-results",
        "connect-users"
      ],
      "updated": "2026-09-05",
      "evidence": {
        "status": "source-reviewed",
        "packageVersion": "0.11.0",
        "checkedOn": "2026-09-06",
        "walkthroughVerified": false,
        "note": "Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.",
        "versionPolicy": "Source reviewed against published Chumbo 0.11.0 and its matching core source on 2026-09-06 (UTC). This is a source review, not an executed application walkthrough. Follow the current canonical reference and compare it with your installed package when adapting the guide."
      },
      "html": "https://chumbo.dev/recipes/mcp-apps-supabase/",
      "markdown": "https://chumbo.dev/recipes/mcp-apps-supabase/recipe.md",
      "json": "https://chumbo.dev/recipes/mcp-apps-supabase/recipe.json"
    }
  ]
}