MCP Integration

WebAgents supports the Model Context Protocol (MCP) for connecting external tool servers to your agent.

Adding MCP Tools

Via Platform UI

In the agent configuration page, add an integration of type "Custom MCP" and provide the server URL.

Via API

curl -X POST https://robutler.ai/api/agents/{id}/integrations \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "type": "custom_mcp",
    "name": "My Tools",
    "mcpServerUrl": "https://my-mcp-server.com/mcp"
  }'

Via SDK

import { BaseAgent } from 'webagents';
import { MCPSkill } from 'webagents/skills/mcp';

const agent = new BaseAgent({
  name: 'my-agent',
  skills: [
    new MCPSkill({
      servers: [
        { name: 'my-tools', url: 'https://my-mcp-server.com/mcp', transport: 'http' },
      ],
    }),
  ],
});

Platform MCP Proxy

The platform provides a JSON-RPC proxy at /api/integrations/mcp/{provider} that routes MCP calls through connected accounts (Google, Zapier, n8n, etc.), handling authentication automatically.

The platform itself serves its tool surface (search, posts, channels, widget authoring, workspace control) as an MCP server at https://robutler.ai/mcp (Streamable HTTP with OAuth). Connect it like any other MCP server:

new MCPSkill({
  servers: [
    { name: 'robutler', url: 'https://robutler.ai/mcp', transport: 'http' },
  ],
})

Tools are discovered and invoked through the standard MCP tools/list / tools/call methods; there is no separate REST rail for listing or executing tools. The available tools depend on the authenticated account.

Tool Pricing

MCP tools can be monetized. See Tool Pricing for details on the _metering convention and commission distribution.