Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Fantasy Tabletop Helper MCP Server list my campaigns, then find NPCs in Westruun tied to a religion"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Connect Claude Desktop, Cursor, Codex, or any MCP-capable client to your tabletop campaigns, and ask questions about your own world in plain language.
"Which NPCs in Westruun belong to a religion, and which of them have my party already met?"
This repository holds the connection docs and example client configs. The server itself is hosted — it runs inside fantasytabletophelper.com, so there is nothing to install, clone, or keep running.
Endpoint: https://www.fantasytabletophelper.com/api/mcp — keep the www., see below
Transport: stateless Streamable HTTP, POST only
Access: Hero plan + PAT (ftth_mcp_…). Reads plus controlled writes (proposals / notes / events you authored). Not OAuth — that is a separate issue.
Source: closed. The app is a commercial product; this repo is the client-side half.
The server queries the database as you, not as an administrator. Row-level security decides the answer, so it can only ever show what the website would show you when logged in.
Writes exist, and they are bounded: notes and events you authored, recaps you submit, and proposals for the DM to review. Nothing an AI tool does through this connection becomes campaign canon until a DM reviews it in the app.
Who sees it | |
Party notes | Campaign members |
DM-only notes | The DM of that campaign, or whoever wrote them |
Private notes | Only their author |
Codex entries | Members of that campaign; non-canon entries only for the DM |
If you are a player, pointing an AI client at your campaign cannot surface your DM's secrets. That is enforced in the database, not in application code.
Related MCP server: World Anvil MCP Server
Tool | Returns |
| Your campaigns, and your role in each |
| One campaign's details |
| Sessions, most recently played first |
| NPCs, locations, items, lore, religions, cultures, groups |
| One codex entry in full, with its relationships |
| Notes from a single session |
| Session recap — plus DM prep hooks if you are the DM |
| Add a note (visibility required) |
| Save a recap you wrote |
| Propose a codex entry for the DM to review |
| Propose a link between two existing entries |
| Rolls and combat events you may read |
| Append one typed event (roll / hit / heal…) |
| Latest ready transcript — DM only, never the audio |
Factions and guilds are stored as kind: "group" — there is no separate
faction kind.
On the site, go to Account → AI Tool Access (/account/mcp), name the token
after the tool you are connecting, and press Create token.
The token appears once, beginning ftth_mcp_. Copy it then. Only a hash is
stored, so it cannot be shown again. If you lose one, revoke it and make another.
Ready-to-edit files are in examples/. Claude Desktop, for
instance:
{
"mcpServers": {
"ftthelper": {
"url": "https://www.fantasytabletophelper.com/api/mcp",
"headers": { "Authorization": "Bearer ftth_mcp_YOUR_TOKEN_HERE" }
}
}
}Restart the client. ftthelper should appear in its tool list.
www.It is not cosmetic. The bare domain redirects to www, and HTTP clients drop the
Authorization header whenever a redirect changes origin — sensibly, since they
cannot know the new host deserves your credentials. Point a client at
https://fantasytabletophelper.com/api/mcp and the token is stripped in transit,
so the server sees an anonymous request and answers 401 Invalid or missing MCP token for a perfectly good token.
"List my campaigns, then find every religion in the Westruun one."
Press Revoke next to it on Account → AI Tool Access. It takes effect on that client's next request. Revoke any token you have pasted somewhere you no longer control.
Symptom | Cause |
| Wrong path, or the server is switched off on this deployment. |
| Almost always the URL: the bare domain instead of |
| Token is wrong, revoked, or expired. Make a new one. |
| We could not open a session for your account. Usually transient; retry. |
| Your plan is not Hero. |
| Soft rate limit (~60 requests/min per token). Wait for |
| Expected. The server is POST-only; your client should be using POST. |
Connects, but every tool call returns an error | A server-side configuration problem. Contact support — the server logs these. |
A tool returns an empty list | Usually genuine: you have no campaigns yet, or the search matched nothing. |
The last two rows are worth keeping apart. An empty list is an answer; an error is a fault.
Docs and example configs: MIT. The hosted service has its own terms.
This server cannot be deployed
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.
Manage your tabletop RPG campaign from any MCP client: worlds, sessions, quests, lore, recaps.
Campaign manager for D&D and TTRPG GMs: your AI reads and writes a live typed campaign database.
