MCP Integration Guide

What is MCP?

The Model Context Protocol (MCP) is a standard for connecting AI assistants to external tools and data sources. The SendAfrica Agent implements MCP to expose its SMS, Email, and Documentation tools to any compatible AI assistant.

Integration Options

1. Stdio Transport (Local)

Run the agent as a local MCP server for direct integration with AI assistants.

Claude Desktop Configuration:

{
  "mcpServers": {
    "sendafrica": {
      "command": "uv",
      "args": ["run", "sendafrica-agent", "mcp"],
      "cwd": "/path/to/SendAfrica-Agent"
    }
  }
}

Start the server:

uv run sendafrica-agent mcp

2. SSE Transport (Remote)

The agent also supports Server-Sent Events (SSE) transport when running as a FastAPI service.

Endpoint: http://localhost:8000/sse

Configuration for remote MCP:

{
  "mcpServers": {
    "sendafrica": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Safety Guardrails

Transport Security

The SSE transport is configured with permissive security settings for development:

TransportSecuritySettings(
    allowed_hosts=["*"],
    allowed_origins=["*"]
)

For production, restrict these to your specific domains.