Connect your tools

Cairn has an MCP server. A client that follows the MCP authorization flow signs in through your browser, and a script uses a token. This page lists what each choice allows and what an agent can call.

Sign in through your browser

One command adds Cairn as an MCP server, and a client that follows the MCP authorization flow does the rest.

claude mcp add --transport http cairn https://app.cairnroadmap.com/mcp

A client that follows the MCP authorization flow opens your browser, you sign in with Google and Cairn asks you to approve the agent. We have tested this flow with the official MCP SDK client, so what you see in another client may differ. From then on the agent acts as you, with your role as it is now. Settings lists the connection and lets you revoke it.

Use a token for scripts

A client that cannot open a browser, a script or a CI job uses a token. Create one in Settings, in the Access tokens tab: choose what it may do and when it ends. The token is shown once. The command below is the one for Claude Code.

claude mcp add --transport http cairn https://app.cairnroadmap.com/mcp --header "Authorization: Bearer $CAIRN_TOKEN"

Any client that sends the token as a Bearer header works the same way.

What a token can do

A token never does more than the member who owns it, and every token ends within a year at most.

Read lets the agent read the roadmap, search, find a project and read changes.
Write does everything read does and also creates and updates projects and programmes, sets a status and archives.
Share does everything read does and also makes, lists and revokes share links.
Full has the three above in one token.

The tools

A connected agent can call these 22 tools. The server has a few more, for features this page does not cover.

Reading

list_programmes
get_programme
list_projects
get_project
find_project
search
get_changes
list_comments
get_roadmap_summary
get_workspace

Writing

create_project
create_programme
upsert_project
upsert_programme
bulk_upsert
set_status
add_comment
archive_project
archive_programme

Share links

create_share_link
list_share_links
revoke_share_link

Short answers and dry runs

Every read answers in about 20,000 characters or fewer, with a cursor or a hint for the rest. The tools that create or update a project or a programme take a dryRun flag, and the answer shows what would change without saving it.

More about agents

Questions

Something unclear or missing here? Tell us what you were trying to connect.

Write to us