Skip to main content
Configure the Babylon MCP server for your deployment.

​
Using the MCP Handler

Babylon provides an MCP request handler that you can integrate into your application: 
import { MCPRequestHandler } from '@babylon/mcp';

const handler = new MCPRequestHandler();

// Handle incoming requests
app.post('/mcp', async (req, res) => {
  const authContext = {
    apiKey: req.headers['x-babylon-api-key'] as string
  };
  
  const response = await handler.handle(req.body, authContext);
  res.json(response);
});

​
Protocol Versions

The MCP server supports multiple protocol versions: 
const MCP_PROTOCOL_VERSIONS = [
  '2024-11-05',
  '2025-03-26',
  '2025-06-18',
];

​
Initialize Response

The initialize method returns server information: 
{
  "jsonrpc": "2.0",
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {
        "listChanged": false
      }
    },
    "serverInfo": {
      "name": "Babylon MCP Server",
      "version": "1.0.0"
    }
  },
  "id": 1
}

​
LLM Integration

See Examples for complete OpenAI and Claude integration code, including tool format conversion and tool-call handling loops.

​
Tool Input Schemas

Each tool has a JSON Schema for its inputs: 
interface MCPTool {
  name: string;
  description: string;
  inputSchema: {
    type: 'object';
    properties: Record<string, {
      type: string;
      description?: string;
      enum?: string[];
      default?: any;
    }>;
    required?: string[];
  };
}

​
Available Exports

The @babylon/mcp package exports: 
// Handlers
export { MCPRequestHandler } from './handlers';

// Types
export type {
  JsonRpcRequest,
  JsonRpcResponse,
  MCPTool,
  ToolCallParams,
  ToolCallResult,
  InitializeParams,
  InitializeResult,
  AuthenticatedAgent,
  MCPAuthContext,
} from './types';

// Authentication
export { authenticateAgent } from './auth';

// Server utilities
export { getAvailableTools, getInitializeResult } from './server';

​
Next Steps

Examples

Working code

Testing

Test integration