capacities_search
Read-only
Search for specific content within designated spaces on Capacities MCP Server using optional filters for structure and search mode to refine results.
Instructions
Search for content across Capacities spaces with optional filtering
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filterStructureIds | No | Optional array of structure IDs to filter results | |
| mode | No | Search mode: fullText or title only | title |
| searchTerm | Yes | The search term to look for | |
| spaceIds | Yes | Array of space UUIDs to search in |
Implementation Reference
- src/tools/search.ts:12-40 (handler)Handler function that executes the capacities_search tool by constructing a request body from parameters and making a POST request to the /search API endpoint, returning the JSON response.
execute: async (args: { searchTerm: string; spaceIds: string[]; mode?: "fullText" | "title"; filterStructureIds?: string[]; }) => { try { const requestBody = { searchTerm: args.searchTerm, spaceIds: args.spaceIds, ...(args.mode && { mode: args.mode }), ...(args.filterStructureIds && { filterStructureIds: args.filterStructureIds, }), }; const response = await makeApiRequest("/search", { method: "POST", body: JSON.stringify(requestBody), }); const data = await response.json(); return JSON.stringify(data, null, 2); } catch (error) { throw new Error( `Failed to search content: ${error instanceof Error ? error.message : String(error)}`, ); } }, - src/tools/search.ts:42-56 (schema)Zod schema defining the input parameters for the capacities_search tool: searchTerm (string), spaceIds (array of UUIDs), optional mode (enum), optional filterStructureIds (array of UUIDs).
parameters: z.object({ searchTerm: z.string().describe("The search term to look for"), spaceIds: z .array(z.string().uuid()) .describe("Array of space UUIDs to search in"), mode: z .enum(["fullText", "title"]) .optional() .describe("Search mode: fullText or title only") .default("title"), filterStructureIds: z .array(z.string().uuid()) .optional() .describe("Optional array of structure IDs to filter results"), }), - src/server.ts:26-26 (registration)Registration of the searchTool (capacities_search) with the FastMCP server.
server.addTool(searchTool);