Agenium Bridge

Bidirectional bridge between MCP (Model Context Protocol) servers/tools and agent:// protocol agents.

Features

• MCP → agent:// — Expose MCP servers as agent:// endpoints so other agents can call MCP tools
• agent:// → MCP — Expose agent:// agents as MCP tools so LLMs can use agents via MCP

Installation

pip install -e .

Usage

Expose MCP tools as an agent

from mcp_agenium import MCPToAgentBridge

bridge = MCPToAgentBridge(
    mcp_server="npx @modelcontextprotocol/server-filesystem /tmp",
    agent_name="filesystem",
    agent_domain="tools",
)
await bridge.start(port=8080)
# Now accessible as agent://filesystem.tools

Use agents as MCP tools

from mcp_agenium import AgentToMCPBridge

bridge = AgentToMCPBridge(
    agents=["agent://search.agenium", "agent://weather.agenium"]
)
mcp_tools = await bridge.get_tools()  # Returns MCP-compatible tool definitions
result = await bridge.call_tool("search_agenium_search", {"query": "hello"})

Bridge Server (MCP JSON-RPC)

from mcp_agenium import AgentToMCPBridge, BridgeServer

bridge = AgentToMCPBridge(agents=["agent://search.agenium"])
server = BridgeServer(bridge)
await server.run_stdio()  # Speaks MCP protocol on stdin/stdout

Development

pip install -e ".[dev]"
pytest

Domain Registration

Supports optional domain registration on the Agenium DNS system using a marketplace API key (dom_<64 hex>). Pass api_key parameter to auto-register your agent on startup. Get your API key from the Telegram Domain Marketplace.

License

MIT