MCP Server
:::note
All MCP tools require a user_id to identify who is creating or modifying knowledge. In practice, the MCP server authenticates via the API key and resolves user_id automatically from the key — you do not need to pass it explicitly.
:::
search-knowledge
{
"name": "search-knowledge",
"arguments": {
"query": "kubernetes pod crashloop after deploy",
"scope": "global",
"limit": 5,
"detail": "standard"
}
}Response includes an array of matching knowledge entries with relevance scores.
create-knowledge
{
"name": "create-knowledge",
"arguments": {
"title": "Fix OOM kills in Node.js containers",
"body": "Node.js containers get OOM killed under load in k8s. Set --max-old-space-size to 75% of container memory limit. Root cause: V8 heap grows beyond container memory limit by default.",
"scope": "project"
}
}The response includes a suggested_scope field with an AI-recommended scope and reason. If the suggested scope differs from the saved scope, consider updating it via update-knowledge.
resolve-knowledge
{
"name": "resolve-knowledge",
"arguments": {
"knowledge_id": "550e8400-e29b-41d4-a716-446655440000",
"comment": "Confirmed fix works on production cluster"
}
}Marks the knowledge entry as resolved and adds an optional comment.
get-knowledge
{
"name": "get-knowledge",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"detail": "full"
}
}update-knowledge
{
"name": "update-knowledge",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"body": "Updated: set --max-old-space-size AND configure resource limits in deployment.yaml",
"add_tags": ["production"],
"remove_tags": ["draft"]
}
}list-knowledge
{
"name": "list-knowledge",
"arguments": {
"scope": "project",
"limit": 10
}
}delete-knowledge
{
"name": "delete-knowledge",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}comment-knowledge
{
"name": "comment-knowledge",
"arguments": {
"knowledge_id": "550e8400-e29b-41d4-a716-446655440000",
"body": "Also applies to ElastiCache clusters",
"type": "supplement"
}
}Comment types: supplement, warning, deprecation, reference.
check-knowledge
{
"name": "check-knowledge",
"arguments": {
"query": "redis timeout kubernetes"
}
}Returns matching knowledge if it exists, without creating anything.