add_mcp_server

Connect the agent to an external Model Context Protocol (MCP) server. Tools are discovered via the MCP protocol at session start and automatically registered as SWAIG functions. Optionally, the server’s resources can be fetched into the agent’s global data.

This method connects your agent to an MCP server as a client. To expose your agent’s own tools as an MCP server, use enable_mcp_server().

Parameters

url

strRequired

MCP server HTTP endpoint URL.

headers

Optional[dict[str, str]]

Optional HTTP headers sent with every request to the MCP server (e.g., {"Authorization": "Bearer sk-xxx"}).

resources

boolDefaults to False

Whether to fetch the server’s resources into the agent’s global_data.

resource_vars

Optional[dict[str, str]]

Variables for URI template substitution when fetching resources. Supports SignalWire call variables such as ${caller_id_number}.

Returns

AgentBase — Returns self for method chaining.

Example

1 from signalwire import AgentBase
2 
3 agent = AgentBase(name="assistant", route="/assistant")
4 agent.set_prompt_text("You are a helpful assistant.")
5 agent.add_mcp_server(
6     url="https://mcp.example.com/sse",
7     headers={"Authorization": "Bearer sk-xxx"},
8     resources=True,
9     resource_vars={"caller_id": "${caller_id_number}"}
10 )
11 agent.serve()

1	from signalwire import AgentBase
2
3	agent = AgentBase(name="assistant", route="/assistant")
4	agent.set_prompt_text("You are a helpful assistant.")
5	agent.add_mcp_server(
6	url="https://mcp.example.com/sse",
7	headers={"Authorization": "Bearer sk-xxx"},
8	resources=True,
9	resource_vars={"caller_id": "${caller_id_number}"}
10	)
11	agent.serve()