Input Schema
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"description": "Project ID (optional, uses session default)"
},
"query": {
"type": "string",
"description": "Natural language query for semantic search"
},
"typeId": {
"type": "string",
"description": "Filter by content type ID"
},
"status": {
"type": "string",
"enum": ["draft", "modified", "published", "unpublished", "deleted"],
"description": "Filter by status (defaults to published content only)"
},
"tags": {
"type": "array",
"items": { "type": "string" },
"description": "Filter by tags (names or IDs)"
},
"page": {
"type": "number",
"default": 1
},
"limit": {
"type": "number",
"default": 20,
"maximum": 100
}
}
}
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
projectId | string | session default | Project to search in |
query | string | - | Natural language semantic search query |
typeId | string | - | Filter by content type |
status | string | published | Filter by status |
tags | string[] | - | Filter by tags |
page | number | 1 | Page number |
limit | number | 20 | Items per page (max 100) |
Response
| Field | Type | Description |
|---|---|---|
items | array | Array of content objects |
items[].id | string | Unique content identifier |
items[].name | string | Display name/title |
items[].description | string | Content description |
items[].status | string | Publication status |
items[].typeId | string | Content type identifier |
items[].typeVersion | number | Content type schema version |
items[].tags | string[] | Categorization tags |
items[].excerpt | string | Relevant text excerpt (with query) |
items[].similarity | number | Similarity score 0-1 (with query) |
items[].metadata | object | Additional metadata |
total | number | Total matching items |
Example
Request
{
"query": "design system case study",
"typeId": "ct_story_001"
}
Response
{
"items": [
{
"id": "cont_story_acme_001",
"name": "How Acme Corp Unified Multiple Products",
"description": "A comprehensive case study of digital transformation.",
"status": "published",
"typeId": "ct_story_001",
"typeVersion": 1,
"tags": ["case-study", "design-system"],
"excerpt": "...inconsistent user experiences across platforms...",
"similarity": 0.89,
"metadata": {
"author": "content-team@acme.com",
"publishedAt": "2024-06-15T10:00:00Z",
"locale": "en-US"
}
}
],
"total": 1
}
Usage
Semantic Search
Search using natural language:const result = await mcp.call("search_content", {
query: "tutorials about getting started"
});
Filter by Content Type
Find all content of a specific type:const result = await mcp.call("search_content", {
typeId: "ct_story_001"
});
Filter by Tags
Find content with specific tags:const result = await mcp.call("search_content", {
tags: ["featured", "tutorial"]
});
Combined Search
Combine semantic search with filters:const result = await mcp.call("search_content", {
query: "product launch announcement",
typeId: "ct_story_001",
status: "published",
tags: ["marketing"]
});
Find Draft Content
Search for unpublished content:const result = await mcp.call("search_content", {
status: "draft"
});