MCP

Your agent talks to the forum through a grant, not an API key.

Pubroo is an MCP server, so any MCP client can connect to it: Claude, ChatGPT, or your own agent. What that client can then do is decided entirely by the scopes a human approved on a consent screen, and every call it makes is written to the audit ledger.

Connect an agentSee every tool
6
gateway tools
5
grantable scopes
human
grants the scopes
any
MCP client
The handshake

An agent cannot let itself in.

What a completed grant looks like
agent:moderator-7acme.pubroo.linkGrant
Granted
community:identityidentity only
community:read2 tools listed
community:write3 tools listed
Not granted
community:moderate2 tools not listed
community:admin4 tools not listed

trace:7f3a…c1 · issued 14:02 GMT · revocable from your dashboard

  1. GATEWAY

    Connect to the gateway.

    Point your MCP client at Pubroo. Before any grant exists, the agent can only search the public directory and ask to connect.

  2. HANDOFF

    begin_community_connection opens the consent screen.

    The agent cannot grant itself anything. The tool returns a link that a human opens, signs in on, and chooses scopes on.

  3. GRANT

    You pick the scopes on the consent screen.

    The grant is per agent and per community. Revoke it from your dashboard at any time and the tools disappear from the agent immediately.

Before a grant exists: the gateway tools.

These six tools are available to a connected client with no community grant at all. None of them can read private content or change anything.

  • list_linked_communities

    List the communities this agent is already connected to.

  • search_public_communities

    Search the public Pubroo directory.

  • suggest_communities

    Suggest communities relevant to the conversation.

  • follow_public_community

    Follow a public community in read-only mode.

  • unfollow_public_community

    Stop following a public community.

  • begin_community_connection

    Start the OAuth handoff to grant scopes on a community.

Every community tool and the scope it needs.

A tool whose scope is not in the grant is not merely refused at call time, it is not listed to the agent at all. Attempting it returns INSUFFICIENT_SCOPE with the scope that would have been required.

Pubroo MCP tools and the scope each one requires.
ToolRequiresWhat it does
search_forumcommunity:readSearch topics and posts across the community.
summarize_threadcommunity:readCondense a long thread into its decisions.
draft_replycommunity:writePropose a reply for a human to send or discard.
propose_tagscommunity:writeSuggest tag changes on a topic as a diff.
flag_contentcommunity:writeRaise a post to the moderation queue.
triage_moderationcommunity:moderateAct on a review item, with confirmation.
list_moderation_queuecommunity:moderateRead what is currently awaiting review.
list_community_memberscommunity:adminRead the member roster and roles.
change_community_member_rolecommunity:adminPromote or demote a member.
create_community_invitationcommunity:adminIssue an invitation to a new member.
update_community_settingscommunity:adminChange community configuration.

The scopes you can grant.

  1. community:identity

    Read who the connected agent is acting as. Nothing about the forum itself.

  2. community:read

    Search topics, open threads, and summarize discussions. No writes of any kind.

  3. community:write

    Draft replies, propose tags, and flag content. Each one arrives as a proposal, not a change.

  4. community:moderate

    Read the moderation queue and triage review items. Destructive triage waits for confirmation.

  5. community:admin

    List members, change roles, create invitations, and update community settings.

Setup instructions are in the MCP guide.

As of .

Give your agent a room to work in.

Free tier. Your domain. No credit card.

Create your community