Tools

47 tools in 6 groups. Each tool except whoami needs a permission in the ACP category “MCP server” (closely related tools share one), needs the token scope shown, and only works where the member’s phpBB permissions allow the same action on the website.

AI apps only see the tools the member may use. Tools marked changes data write to the board; all moderation tools that change something show a preview first and need a confirmation.

Reading

Read what the member can read on the board. The permissions for these tools are in phpBB’s standard user roles, so granting “Can use the MCP server” is usually enough.

Tool	What it does	Token scope	Since
`whoami`	The board, the member the token acts as, and its scopes.	`forum:read`	0.1.0
`list_forums`	The forums the member can read.	`forum:read`	0.1.0
`list_topics`	Topics in a forum, by most recent activity.	`forum:read`	0.1.0
`read_topic`	The posts of a topic, page by page.	`forum:read`	0.1.0
`get_post`	One post; for the member’s own posts also the BBCode source.	`forum:read`	0.1.0
`search_posts`	Search with phpBB’s own search backend.	`forum:read`	0.1.0
`search`	Search in the shape ChatGPT connectors and deep research expect.	`forum:read`	0.1.0
`fetch`	Fetch a search result, in the shape ChatGPT expects.	`forum:read`	0.1.0

Writing

Post as the member, with the same checks as the posting page for a member without moderator powers: forum permissions, locked topics, edit time, approval and flood control.

Tool	What it does	Token scope	Since
`create_topic` changes data	Start a topic.	`forum:write`	0.1.0
`reply_topic` changes data	Reply to a topic.	`forum:write`	0.1.0
`edit_post` changes data	Edit one of the member’s own posts.	`forum:write`	0.1.0

Private messages

Reading messages changes nothing: they stay unread until the client marks them read.

Tool	What it does	Token scope	Since
`list_pms`	Messages in a folder, with unread counts.	`pm:read`	0.1.0
`read_pm`	One message.	`pm:read`	0.1.0
`mark_pm_read` changes data	Mark a message as read.	`pm:write`	0.1.0
`send_pm` changes data	Send a message to one or more members.	`pm:write`	0.1.0

Moderation: review

Read-only tools for moderators. IP addresses are shown as pseudonymous handles unless the board allows raw addresses.

Tool	What it does	Token scope	Since
`list_moderation_queue`	Queued and soft deleted posts and topics, and open reports.	`moderate:read`	0.1.0
`get_report`	A post or private message report.	`moderate:read`	0.1.0
`get_post_details`	A post with its moderation details.	`moderate:read`	0.1.0
`get_moderator_log`	Entries of the moderator log.	`moderate:read`	0.1.0
`get_user_moderation_profile`	A member’s account state, activity, warnings, bans and notes.	`moderate:read`	0.1.0
`list_user_posts`	A member’s posts, newest first, to judge whether an account posts spam.	`moderate:read`	0.1.0
`list_recent_registrations`	New accounts, for spotting spam sign-ups.	`moderate:read`	0.1.0
`find_users_by_ip`	Accounts that used an address.	`moderate:read`	0.1.0
`list_deletion_queue`	Spam accounts waiting to be deleted.	`moderate:read`	0.1.0

Moderation: content

Every change is a dry run first, with a preview and a confirmation token; only a second call with that token makes the change. Disapproving and permanent deletion also need their own board setting.

Tool	What it does	Token scope	Since
`approve_posts` changes data	Approve queued posts.	`moderate`	0.1.0
`approve_topics` changes data	Approve queued topics.	`moderate`	0.1.0
`soft_delete_posts` changes data	Soft delete posts (can be undone).	`moderate`	0.1.0
`soft_delete_topics` changes data	Soft delete topics (can be undone).	`moderate`	0.1.0
`restore_posts` changes data	Restore soft deleted posts.	`moderate`	0.1.0
`restore_topics` changes data	Restore soft deleted topics.	`moderate`	0.1.0
`lock_topics` changes data	Lock topics.	`moderate`	0.1.0
`unlock_topics` changes data	Unlock topics.	`moderate`	0.1.0
`close_reports` changes data	Close reports.	`moderate`	0.1.0
`moderate_edit_post` changes data	Edit another member’s post, with a visible edit reason.	`moderate`	0.1.0
`move_topics` changes data	Move topics to another forum.	`moderate`	0.1.0
`disapprove_posts` changes data	Disapprove queued posts (deletes them).	`moderate`	0.1.0
`disapprove_topics` changes data	Disapprove queued topics (deletes them).	`moderate`	0.1.0
`delete_posts_permanently` changes data	Delete posts for good.	`moderate`	0.1.0
`delete_topics_permanently` changes data	Delete topics for good.	`moderate`	0.1.0

Moderation: members

Founders, staff, bots and, unless the moderator overrides it, established members are protected. Bans never shorten an existing ban.

Tool	What it does	Token scope	Since
`warn_user` changes data	Warn a member, optionally for a post.	`moderate:users`	0.1.0
`add_user_note` changes data	Add a moderator note to a member.	`moderate:users`	0.1.0
`ban_user` changes data	Ban a member and revoke their tokens and connected apps.	`moderate:users`	0.1.0
`unban_user` changes data	Lift a member’s account ban.	`moderate:users`	0.1.0
`ban_ip` changes data	Ban one IP address.	`moderate:users`	0.1.0
`ban_email` changes data	Ban one e-mail address.	`moderate:users`	0.1.0
`purge_spammer` changes data	Ban a spam account (up to 50 posts), revoke its tokens, hide all its posts and, by default, queue the account for deletion.	`moderate moderate:users`	0.1.0
`cancel_account_deletion` changes data	Take an account off the deletion queue.	`moderate:users`	0.1.0