MCP-Smallest.ai

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'
  };