A Model Context Protocol (MCP) server that wraps the Bakul AI API endpoints.

This MCP server provides tools for:

• Health Check: Verify API availability
• User Registration: Create new user accounts
• API Key Management: Rotate authentication keys
• Dataset Management: Create and update datasets
• Public Dataset Access: Retrieve public datasets and schemas

• health_check - Check API health status
• register_user - Register a new user account
• rotate_api_key - Rotate API authentication key
• get_api_key_status - Check API key configuration and test authentication

• create_dataset - Create a new dataset
• update_dataset - Update an existing dataset
• get_public_dataset - Retrieve a public dataset by username and ID
• get_public_dataset_schema - Get the schema of a public dataset

pnpm install

pnpm dev

pnpm start

The server runs on stdio and communicates via the MCP protocol.

The server connects to the Bakul API at https://ba.kul.to/api.

1. Get an API Key: Register a new user using the register_user tool
2. Set Environment Variable:

   export BAKUL_API_KEY=your_api_key_here

3. Alternative: Use the API_KEY environment variable

See config.example for a configuration template.

• BAKUL_API_KEY - Your Bakul API key (primary)
• API_KEY - Alternative API key variable (fallback)

Each tool includes built-in usage instructions in its responses to help guide AI agents on proper usage patterns.

• Uses TypeScript with tsx for runtime execution
• Zod schemas for input validation
• Includes comprehensive error handling
• All API responses include tool usage guidance for AI agents

The server wraps endpoints documented in the Bakul API OpenAPI specification.