createKnowledgeBase
Create structured knowledge bases by defining names and descriptions, enabling organized information management within the MCP-Smallest.ai server system.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | ||
| name | Yes |
Implementation Reference
- index.ts:50-77 (handler)The handler function that implements the createKnowledgeBase tool. It makes a POST request to the /knowledgebase endpoint with the provided name and description, returns the JSON response or an error.async (args) => { try { const response = await fetch(`${config.BASE_URL}/knowledgebase`, { method: 'POST', headers: { 'Authorization': `Bearer ${config.API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ name: args.name, description: args.description }) }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const data = await response.json(); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'; console.error('Error creating knowledge base:', error); return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true }; } }
- index.ts:46-49 (schema)Zod schema defining the input parameters for the createKnowledgeBase tool: name (string) and description (string).{ name: z.string(), description: z.string() },
- index.ts:44-78 (registration)The server.tool() call that registers the createKnowledgeBase tool with its schema and handler function.server.tool( "createKnowledgeBase", { name: z.string(), description: z.string() }, async (args) => { try { const response = await fetch(`${config.BASE_URL}/knowledgebase`, { method: 'POST', headers: { 'Authorization': `Bearer ${config.API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ name: args.name, description: args.description }) }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const data = await response.json(); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'; console.error('Error creating knowledge base:', error); return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true }; } } );
- config.ts:1-4 (helper)Configuration module providing API_KEY and BASE_URL constants used by the createKnowledgeBase handler for authentication and endpoint.export const config = { API_KEY: 'smallest-ai-api-key', BASE_URL: 'https://atoms-api.smallest.ai/api/v1' };