Skip to main content
Search for content using standard filters or semantic search.

​
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

ParameterTypeDefaultDescription
projectIdstringsession defaultProject to search in
querystring-Natural language semantic search query
typeIdstring-Filter by content type
statusstringpublishedFilter by status
tagsstring[]-Filter by tags
pagenumber1Page number
limitnumber20Items per page (max 100)

​
Response

FieldTypeDescription
itemsarrayArray of content objects
items[].idstringUnique content identifier
items[].namestringDisplay name/title
items[].descriptionstringContent description
items[].statusstringPublication status
items[].typeIdstringContent type identifier
items[].typeVersionnumberContent type schema version
items[].tagsstring[]Categorization tags
items[].excerptstringRelevant text excerpt (with query)
items[].similaritynumberSimilarity score 0-1 (with query)
items[].metadataobjectAdditional metadata
totalnumberTotal 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": "[email protected]",
        "publishedAt": "2024-06-15T10:00:00Z",
        "locale": "en-US"
      }
    }
  ],
  "total": 1
}

​
Usage

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"]
});
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"
});