MCP

💡 Use the bkend MCP server to manage your backend with natural language from AI tools like Claude Code, Cursor, and VS Code.

Overview

bkend connects to AI tools through MCP (Model Context Protocol). When you issue natural language commands from an MCP-compatible AI tool, bkend automatically manages Database, Auth, and Storage for you.

---

MCP Server Information

Item	Value
Server URL	https://api.bkend.ai/mcp
Protocol Version	2025-03-26
Transport	Streamable HTTP
Authentication	OAuth 2.1 + PKCE
Message Format	JSON-RPC 2.0

---

Available Tools

Fixed Tools

These tools handle session context and documentation search.

Tool	Description	Details
get_context	Must be called at session start — provides Organization ID, resource hierarchy, and usage guidelines	Context
search_docs	Search bkend documentation — API guides, auth implementation, CRUD patterns, code examples	Context

API Tools

These tools directly manage your backend. They all use the backend_ prefix.

Category	Tool Count	Description	Details
Project Management	9	Manage Organizations, projects, environments, and access tokens	Project Tools
Table Management	7	Manage tables, fields, indexes, and schema versions	Table Tools

REST API Code Generation

Auth, Storage, and Data CRUD do not have dedicated MCP tools. Instead, use search_docs to find implementation guides, then generate REST API code.

Feature	MCP Tool	Alternative
Auth	N/A	Generate REST API code — Code Generation
Storage	N/A	Generate REST API code — Code Generation
Data CRUD	N/A	Generate REST API code — Code Generation

💡 When you ask your AI tool to "implement a login feature" or "add data to a table," search_docs automatically finds the relevant docs and generates the REST API calling code.

⚠️ MCP tools control management functions (table schemas, projects, environments, etc.). They are different from the REST API used for app user data. For REST API integration, see Integrating bkend in Your App.

---

Complete Tool List

---

Resources

MCP Resources let you query the current state in read-only mode through the bkend:// URI schema.

Resource	URI Pattern	Description
Organization	bkend://organizations/{organizationId}	Organization details
Organization List	bkend://organizations	List of Organizations
Project	bkend://projects/{projectId}	Project details
Project List	bkend://projects	List of projects
Environment	bkend://environments/{environmentId}	Environment details
Environment List	bkend://environments	List of environments
Table	bkend://tables/{tableId}	Table details
Table List	bkend://tables	List of tables

For details, see MCP Resources.

---

Permissions (Scopes)

These are the permissions granted during MCP integration.

Resource	Read	Create	Update	Delete
Organization	✅	-	-	-
Project	✅	✅	✅	✅
Environment	✅	✅	-	✅
Table Schema	✅	✅	✅	✅
Table Data	✅	✅	✅	✅
Access Token	✅	-	-	-

---

Quick Start

For the full setup guide, see Setup.

---

Next Steps

• Setup — Install and authenticate your AI tool

• Usage — Prompt examples and best practices

• MCP Protocol — Protocol specification details

• OAuth 2.1 Authentication — Authentication flow and token management

• Context — get_context and search_docs details

• Project Tools — Organization, project, and environment management

• Table Tools — Table, field, and index management

• Code Generation — REST API code generation for Auth, Storage, Data

• Resources — MCP resource URIs

• API Reference — Complete tool schemas

• Hands-on Project Cookbooks — Build real app backends with MCP

Reference Standards

• MCP Specification 2025-03-26

• OAuth 2.1