MCP Knowledge Retrieval Tools
Documentation Querying via MCP
Autonomous agents query the central Aircada knowledge base in real time using two dedicated Model Context Protocol (MCP) tools. These tools allow agents to search the entire guide database or fetch exact node contents, keeping their context lean and grounding their decisions.
get_knowledge_nodes_by_ids Tool Reference#
Tool Overview
The get_knowledge_nodes_by_ids tool retrieves the complete, raw markdown body and metadata of specific Aircada knowledge nodes using their exact string IDs.
Input Schema
{
"name": "get_knowledge_nodes_by_ids",
"description": "Retrieve the complete, exact markdown content of specific Aircada knowledge nodes using their string ID. Use this when following a 'Related ID' link.",
"inputSchema": {
"type": "object",
"properties": {
"nodeIds": {
"type": "array",
"items": { "type": "string" },
"description": "The exact dot-notation ID (e.g., 'element.shape.creation')"
}
},
"required": ["nodeIds"]
}
}Fetching Exact Nodes
Use this tool when following related IDs found under the connections or children arrays of other nodes. This avoids duplicate searches and provides the full, unabridged text directly.
// Example Tool Call
{
"nodeIds": ["docs.apex.architecture", "docs.apex.schema"]
}search_knowledge_nodes Tool Reference#
Tool Overview
The search_knowledge_nodes tool executes a hybrid semantic and keyword search against the entire compiled Aircada knowledge base.
Input Schema
{
"name": "search_knowledge_nodes",
"description": "Search all Aircada documentation. Use this to find concepts, API reference guides, and code examples.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "The search query (e.g., 'how do I configure light shadows?')"
},
"scope": {
"type": "string",
"enum": ["all", "api", "docs.examples"],
"description": "The scope of the search. Use 'all' for general concepts/guides, 'api' for specific class/property/method definitions, and 'docs.examples' for code snippets."
},
"version": {
"type": "string",
"description": "The user's Aircada SDK version (e.g., '1.2.0')"
}
},
"required": ["query"]
}
}Executing Searches
Agents call the tool specifying queries. Use specific search phrases or questions. Narrow the scope if searching specifically for coding templates rather than design concepts.
// Example Tool Call
{
"query": "how do I declare custom materials on shape objects?",
"scope": "docs.examples"
}