# Chumbo recipes Task-oriented recipes for builders and their coding agents. ## Add an MCP server to an existing Supabase app with Chumbo Take an existing Supabase application from a generated MCP function to one useful capability you can discover and call. - [Read the recipe](https://chumbo.dev/recipes/first-supabase-mcp/) - [Full Markdown](https://chumbo.dev/recipes/first-supabase-mcp/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/first-supabase-mcp/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Choose OAuth, bearer, API-key or public auth for a Supabase MCP Choose the Chumbo access mode that fits your callers, with a clear account of which identity reaches your Supabase data. - [Read the recipe](https://chumbo.dev/recipes/choose-mcp-auth/) - [Full Markdown](https://chumbo.dev/recipes/choose-mcp-auth/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/choose-mcp-auth/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Build a Supabase MCP with a coding agent and the Chumbo skill Install project-local Chumbo guidance, preview setup changes and give a coding agent a bounded application task it can verify. - [Read the recipe](https://chumbo.dev/recipes/build-mcp-with-coding-agent/) - [Full Markdown](https://chumbo.dev/recipes/build-mcp-with-coding-agent/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/build-mcp-with-coding-agent/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Connect AI agents to Supabase users with OAuth and Chumbo Give users a sign-in and consent path to your Supabase MCP, then verify the account and permissions behind a real tool call. - [Read the recipe](https://chumbo.dev/recipes/oauth-user-connections/) - [Full Markdown](https://chumbo.dev/recipes/oauth-user-connections/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/oauth-user-connections/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Design useful MCP tools for a Supabase application with Chumbo Turn an existing product operation into a narrow MCP tool with clear inputs, caller-owned access and a result the agent can use. - [Read the recipe](https://chumbo.dev/recipes/design-useful-mcp-tools/) - [Full Markdown](https://chumbo.dev/recipes/design-useful-mcp-tools/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/design-useful-mcp-tools/recipe.json) - Executable example checked: Chumbo 0.11.3 on 2026-09-18 (UTC). The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run. ## Build a Supabase MCP server with your existing RLS policies 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. - [Read the recipe](https://chumbo.dev/recipes/supabase-rls-mcp/) - [Full Markdown](https://chumbo.dev/recipes/supabase-rls-mcp/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/supabase-rls-mcp/recipe.json) - Executable example checked: Chumbo 0.11.3 on 2026-09-18 (UTC). 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. ## Choose text, structured data and error results for Chumbo MCP tools Design readable MCP answers and typed result contracts without dumping database rows or duplicating JSON into text. - [Read the recipe](https://chumbo.dev/recipes/mcp-result-contracts/) - [Full Markdown](https://chumbo.dev/recipes/mcp-result-contracts/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/mcp-result-contracts/recipe.json) - Executable example checked: Chumbo 0.11.3 on 2026-09-18 (UTC). The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run. ## Paginate Supabase MCP tool results with Chumbo Return compact project pages from your Supabase MCP, with bounded results, stable cursors, and a clear next call for agents and typed clients. - [Read the recipe](https://chumbo.dev/recipes/compact-project-results/) - [Full Markdown](https://chumbo.dev/recipes/compact-project-results/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/compact-project-results/recipe.json) - Executable example checked: Chumbo 0.11.3 on 2026-09-18 (UTC). Exact example typechecked and exercised with simulated query results. Verify real auth, RLS, and pagination with your application’s fixtures. ## Add MCP Resources, prompts and usage instructions to a Supabase Chumbo server Add discoverable usage guidance, a readable Resource and a workflow prompt to your MCP without putting a full document in every tool result. - [Read the recipe](https://chumbo.dev/recipes/resources-and-prompts/) - [Full Markdown](https://chumbo.dev/recipes/resources-and-prompts/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/resources-and-prompts/recipe.json) - Executable example checked: Chumbo 0.11.3 on 2026-09-18 (UTC). The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run. ## Return safe mutation receipts from Supabase MCP tools with Chumbo Wrap an existing application write in a narrow MCP tool and return a compact receipt with the resulting state and next step. - [Read the recipe](https://chumbo.dev/recipes/mutation-receipts/) - [Full Markdown](https://chumbo.dev/recipes/mutation-receipts/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/mutation-receipts/recipe.json) - Executable example checked: Chumbo 0.11.3 on 2026-09-18 (UTC). The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run. ## Gate Supabase MCP tools by scopes and application API keys with Chumbo Serve different capability sets from one MCP using application-resolved scopes, with authorization on discovery and direct calls. - [Read the recipe](https://chumbo.dev/recipes/scoped-mcp-capabilities/) - [Full Markdown](https://chumbo.dev/recipes/scoped-mcp-capabilities/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/scoped-mcp-capabilities/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Test Supabase MCP tools and scoped discovery with chumbo/testing Exercise the Chumbo MCP boundary with controlled dependencies, then keep real Supabase authentication and RLS checks as a separate integration layer. - [Read the recipe](https://chumbo.dev/recipes/test-mcp-capabilities/) - [Full Markdown](https://chumbo.dev/recipes/test-mcp-capabilities/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/test-mcp-capabilities/recipe.json) - Executable example checked: Chumbo 0.11.3 on 2026-09-18 (UTC). The exact displayed example is typechecked and exercised against the published package. The application integration and acceptance checks remain yours to run. ## Test, deploy and debug a Chumbo MCP on Supabase Edge Functions Move from local checks to an actual MCP call, diagnose the failing boundary and verify the deployed endpoint your users will connect to. - [Read the recipe](https://chumbo.dev/recipes/deploy-debug-mcp/) - [Full Markdown](https://chumbo.dev/recipes/deploy-debug-mcp/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/deploy-debug-mcp/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Use a custom domain or Next.js route for a Supabase Chumbo MCP Expose your existing MCP at a product-facing URL while preserving the function route, OAuth metadata and request behavior. - [Read the recipe](https://chumbo.dev/recipes/clean-mcp-url/) - [Full Markdown](https://chumbo.dev/recipes/clean-mcp-url/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/clean-mcp-url/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Serve multiple MCP servers from one Supabase Edge Function Resolve a named MCP from the request path, give each surface its own instructions and capabilities, and keep one deployable Supabase Edge Function. - [Read the recipe](https://chumbo.dev/recipes/many-mcps-one-function/) - [Full Markdown](https://chumbo.dev/recipes/many-mcps-one-function/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/many-mcps-one-function/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Add credential-partitioned durable state to a Supabase MCP Use Chumbo's bounded credential-partitioned state for read-before-write receipts while application RLS and resource versions remain authoritative. - [Read the recipe](https://chumbo.dev/recipes/durable-mcp-state/) - [Full Markdown](https://chumbo.dev/recipes/durable-mcp-state/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/durable-mcp-state/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Add lifecycle observability and run correlation to a Chumbo MCP Record redacted capability lifecycle facts, capture the advertised tool surface, and join selected calls into an explicit application run. - [Read the recipe](https://chumbo.dev/recipes/observe-mcp-runs/) - [Full Markdown](https://chumbo.dev/recipes/observe-mcp-runs/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/observe-mcp-runs/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application. ## Build an authenticated MCP App on Supabase with Chumbo Serve a bundled interactive MCP App through one Supabase Edge Function while host-mediated tools preserve the caller's auth, scopes, and RLS boundary. - [Read the recipe](https://chumbo.dev/recipes/mcp-apps-supabase/) - [Full Markdown](https://chumbo.dev/recipes/mcp-apps-supabase/recipe.md) - [Structured instructions](https://chumbo.dev/recipes/mcp-apps-supabase/recipe.json) - Source reviewed: Chumbo 0.11.0 on 2026-09-06 (UTC). Reviewed against the shipped OSS source. The acceptance checks are yours to run in your application.