Install the MCP Server

The @typeroll/mcp-server package connects Claude Code to your Typeroll portal. Once installed, Claude can create pages, update settings, deploy sites and much more — all by calling the tools the MCP server exposes.

1. Get an API key

Log in to app.typeroll.com, open Settings → API Keys, and create a new key. Copy it — you won’t see it again.

API keys look like this:

typeroll_live_5bb88adff25a_b2924f4f715d8459a3752a07bd61daa714b4541f7d769076

2. Add the MCP server

Project scope (recommended)

In your project directory, run:

claude mcp add typeroll -- npx @typeroll/mcp-server

Then open .claude.json (created by Claude Code) and add your credentials to the env block:

{
"mcpServers": {
  "typeroll": {
    "command": "npx",
    "args": ["@typeroll/mcp-server"],
    "env": {
      "TYPEROLL_API_KEY": "typeroll_live_...",
      "TYPEROLL_API_URL": "https://app.typeroll.com"
    }
  }
}
}

This keeps the key scoped to the project. Commit .claude.json to git — the API key is secret, so add it to .env or use a secrets manager if your repo is public.

User scope (all projects)

claude mcp add --scope user typeroll -- npx @typeroll/mcp-server

Then edit ~/.claude.json:

{
"mcpServers": {
  "typeroll": {
    "command": "npx",
    "args": ["@typeroll/mcp-server"],
    "env": {
      "TYPEROLL_API_KEY": "typeroll_live_...",
      "TYPEROLL_API_URL": "https://app.typeroll.com"
    }
  }
}
}

3. Verify the connection

Start Claude Code in your project:

claude

Ask it to list your sites:

What sites do I have in Typeroll?

Claude should call list_sites and respond with your sites. If it says “Missing bearer token” or “Invalid or revoked token”, double-check the API key in your config.

4. Install skills (optional but recommended)

Skills are short markdown files that give Claude step-by-step recipes for common tasks. Without them, Claude still has all the tools — but skills help it pick the right sequence and avoid common pitfalls.

# Project-scoped (recommended)
mkdir -p .claude/skills
npx @typeroll/mcp-server install-skills .claude/skills

# Or user-scoped (available in every project)
npx @typeroll/mcp-server install-skills ~/.claude/skills

Or install manually from the npm package:

npm pack @typeroll/mcp-server
tar xf typeroll-mcp-server-*.tgz
cp package/skills/*.md .claude/skills/

Tip

Skills are just markdown files. You can edit them, add custom ones, or remove ones you don’t need. See What are Skills? for the full list.

Environment variables

Variable	Required	Description
TYPEROLL_API_KEY	✓	API key from your portal settings
TYPEROLL_API_URL	✓	Portal URL. Use https://app.typeroll.com for the hosted version, or your self-hosted URL

Troubleshooting

“Missing bearer token” — TYPEROLL_API_KEY is not set or not reaching the MCP server process. Check that the env block is inside the correct mcpServers entry.

“Invalid or revoked token” — The key was deleted or rotated. Create a new one in Settings → API Keys.

“Site not found” — The site ID doesn’t exist under your account. Use list_sites to see your available sites.

Claude doesn’t use the tools — Make sure you started Claude Code after adding the MCP server. Restart claude to pick up config changes.