Key Principles
Minimal Token Usage
- Returns only fields needed for content creation
- Excludes internal metadata and system fields
- Full schemas and content only returned when explicitly requested via get operations
- Descriptions use structured markdown for better LLM comprehension
Schema-Driven Creation
- All content creation validated against JSON schemas
- Content stored as structured JSON matching schemas
- Compiled BindJS code auto-generated from JSON
- Type safety through schema validation
Semantic Discovery
- Vector search capabilities for finding relevant resources
- Natural language queries for content and component discovery
- AI-optimized descriptions using structured markdown
- Leverages embeddings for conceptual similarity matching
Design System Compliance
- Ensures all created content follows established patterns
- Validates against content type constraints
- Maintains component allowlists and groupings
- Preserves package version dependencies
Dual Search Modes
All search tools support two modes:| Mode | Trigger | Behavior |
|---|---|---|
| Semantic Search | Include query parameter | Uses AI embeddings for natural language queries, returns relevance-ranked results |
| Standard Filtering | Omit query parameter | Uses exact matching on filters, returns consistently ordered results |
Tool Categories
Context Management
Set and manage project context for all operations
Content Discovery
Search and retrieve content types and content items
Component Discovery
List and search available components
Asset Management
Search and discover media assets
Content Creation
Create and update content items
Error Handling
Validation errors and recovery strategies
Tool Summary
| Category | Tool | Description |
|---|---|---|
| Context | set_project | Set default project context |
get_current_project | Get current project context | |
list_projects | List available projects | |
| Content Discovery | search_content_types | Search/list content types |
get_content_type | Get detailed content type schema | |
search_content | Search/list content items | |
get_content | Get detailed content item | |
| Components | list_components | List components with semantic search |
| Assets | search_assets | Search/list media assets |
| Creation | create_content | Create new content items |
update_content | Update existing content |
Naming Conventions
| Element | Convention | Example |
|---|---|---|
| Tool names | snake_case | search_content_types |
| Field names | camelCase | contentTypeId |
| Response fields | camelCase | projectName |
Authentication
MCP tools use the same authentication as the Metabind API. The MCP server handles authentication through the connection parameters established when the client connects.Project Context
All tools accept an optionalprojectId parameter. If not provided, tools use the session’s default project set via set_project. Context persists within a session but requires re-establishment on reconnection.
