MCP Resources

circle-info

💡 This page explains how to query the current state of bkend in read-only mode through MCP Resources.

Overview

Unlike Tools, MCP Resources are read-only. They use the bkend:// URI schema to query the current state of Organizations, projects, environments, and tables. Resources are automatically generated from MCP-enabled GET endpoints.

spinner

Resource URIs

Organization Resources

bkend://organizations
bkend://organizations/{organizationId}

Returns the list of Organizations or details of a specific Organization.

Project Resources

bkend://projects
bkend://projects/{projectId}

Returns the list of projects or details of a specific project.

Environment Resources

Returns the list of environments or details of a specific environment.

Table Resources

Returns the list of tables or details of a specific table (including schema).

Schema and Index Version Resources

Returns the list of schema or index versions for a specific table.

Access Token Resources

Returns the list of access tokens or details of a specific token.


MCP Methods

resources/list

Retrieves the list of available resource URIs.

Response Example

resources/read

Reads the data of a specific resource.

Response Example


Caching

MCP Resources are cached for performance.

Item
Value

Scope

Per Organization

circle-info

💡 Resource data is cached. After creating a new resource, it may not appear immediately in the list.


Resources vs Tools

Aspect
Resources
Tools

Purpose

Query state

Execute operations

Access

Read-only

Read/write

Invocation

URI-based (bkend://...)

Function call (backend_*)

Caching

Yes

None

Example

List projects

Create a table

When should you use Resources?

  • When the AI tool needs to understand the current state (what projects or tables exist)

  • When background information is needed for auto-completion or context

When should you use Tools?

  • When modifying data (creating tables, updating fields, managing indexes)

  • When performing specific operations (searching docs, creating projects)


Usage Flow

spinner

Next Steps

Last updated