Expose a backend to agents and MCP clients

Chatom can expose the same backend contract through pydantic-ai or FastMCP. Both integrations derive available operations from backend capabilities.

Add a backend to a pydantic-ai agent

Install the optional dependency:

pip install 'chatom[agent]'

Create a toolset and pass it to an agent:

from chatom.agent import AccessPolicy, BackendToolset
from pydantic_ai import Agent

policy = AccessPolicy(
    requesting_user=requesting_user,
    invoking_channel_id=channel.id,
    restrict_to_invoking_channel=True,
    require_membership=True,
    block_dm_reads=True,
    max_messages_per_request=50,
)

toolset = BackendToolset(
    backend,
    read_only=True,
    access_policy=policy,
    max_tool_calls=8,
    per_tool_limits={"read_channel_history": 3},
)
agent = Agent("provider:model", toolsets=[toolset])
result = await agent.run("Summarize recent discussion in this channel")

Create a new chatom.agent.BackendToolset for each agent run when using call budgets.

Run the MCP server

Install the MCP extra and select a gateway preset:

pip install 'chatom[mcp]'
export SLACK_BOT_TOKEN='xoxb-...'
chatom-mcp +gateway=slack

Built-in presets are discord, irc, matrix, slack, symphony, symphony_dev, telegram, and zulip. The default transport is stdio.

Each preset reads its credentials from the environment:

Preset

Environment variables

discord

DISCORD_TOKEN

irc

IRC_SERVER, IRC_NICKNAME, IRC_PASSWORD

matrix

MATRIX_HOMESERVER, MATRIX_USER_ID, MATRIX_ACCESS_TOKEN, MATRIX_DEVICE_ID

slack

SLACK_BOT_TOKEN

symphony

SYMPHONY_BOT_KEY

telegram

TELEGRAM_BOT_TOKEN

zulip

ZULIP_SITE, ZULIP_EMAIL, ZULIP_API_KEY

IRC_NICKNAME defaults to chatom and IRC_PASSWORD defaults to empty.

Run a read-only HTTP server:

chatom-mcp +gateway=slack \
  server.transport=http \
  server.host=127.0.0.1 \
  server.port=8080 \
  server.read_only=true

Filter tools with Hydra list overrides:

chatom-mcp +gateway=slack \
  'server.enabled_tools=[read_channel_history,search_messages,lookup_user]'

delete_message and set_presence are disabled by default. With multiple programmatic backends, tool names receive a backend prefix such as slack__send_message.

Build an MCP server in Python

from chatom.mcp import build_mcp_server

mcp = build_mcp_server(
    {"slack": slack_backend, "discord": discord_backend},
    read_only=True,
    disabled_tools={"download_attachment"},
)
mcp.run(transport="stdio")