Resources

A resource represents read-only data or content that can be discovered and retrieved by MCP clients to provide contextual information to Large Language Models (LLMs).

Resources are analogous to file attachments or contextual snippets: they allow the model to inspect data (such as documentation, schema definitions or log files) without needing to invoke executable tools. The Toolbox server implements the following methods from the Model Context Protocol (MCP) specification:

• resources/list: Discovers all concrete/direct resources defined on the server.
• resources/templates/list: Discovers dynamic resource templates with parameterized URI templates.
• resources/read: Retrieves the content and MIME type of a specific resource by its URI.

Toolbox supports two kinds of resources:

1. Static Resources (kind: resource): Fixed entities with a static URI (such as in-memory text snippets or specific disk files).
2. Resource Templates (kind: resourceTemplate): Dynamic resources that match URI patterns (such as exposing any log file within a directory tree using {path}).

kind: resource
name: database_schema_ddl
type: text
description: "Core table definitions and constraints."
uri: "schema://database/ddl"
mimeType: "text/x-sql"
text: |
  CREATE TABLE customers (
    id SERIAL PRIMARY KEY,
    name VARCHAR(255) NOT NULL,
    email VARCHAR(255) UNIQUE NOT NULL
  );
---
kind: resource
name: database_schema
type: file
description: "Application database schema definition."
path: "./schema.sql"
uri: "file:///app/schema.sql"
mimeType: "text/plain"
---
kind: resourceTemplate
name: app_logs
type: file
description: "Application runtime log files."
uriTemplate: "file:///logs/{path}"
allowedPaths:
  - "./logs"

Resource Schema (kind: resource)

Resource Template Schema (kind: resourceTemplate)

Annotations Schema

Annotations provide hints to the client about how the resource content should be prioritized and treated.

Types of Resources

Toolbox supports the following resource primitives:

• Text Resources: Static text content embedded directly in your configuration file.
• File Resources: Specific files stored on disk and served as read-only resources.
• Resource Templates: Parameterized URI templates that dynamically read matching files from sandboxed directories.
• MCP Apps: Interactive HTML web applications and tool visual interfaces for clients supporting the MCP Apps extension.