MCP Server

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI coding assistants connect to external tools and data sources. ArcLume provides an MCP server that gives your AI assistant access to your story maps, outlines, stories, indexed codebase, and library documents — directly from your editor or terminal.

Prerequisites

You'll need an API key to authenticate. Generate one in Settings → MCP in the ArcLume app. API keys use the efk_ prefix.

Setup

Go to Settings → MCP in ArcLume and select your client. The setup page generates the exact config snippet with your API key.

Claude Code

Run this in your terminal:

claude mcp add --transport http arclume https://mcp.arclume.dev/mcp

Then type /mcp in Claude Code to connect. A browser window will open to authorize access — no API key needed.

Cursor

Add this to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "arclume": {
      "url": "https://mcp.arclume.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "arclume": {
      "serverUrl": "https://mcp.arclume.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "arclume": {
      "type": "streamable-http",
      "url": "https://mcp.arclume.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Other Clients

Any MCP-compatible client that supports Streamable HTTP transport can connect. Use the endpoint URL https://mcp.arclume.dev/mcp with an Authorization: Bearer efk_... header.

Authentication

ArcLume MCP uses API key authentication. Create a key in Settings → MCP and include it as a Bearer token in the Authorization header. The key is organization-scoped — it grants access to the organization it was created in.

Available Tools

Once connected, your AI assistant can use these tools:

Organization

• list_organizations — list orgs you belong to and their IDs
• set_default_organization — set a default org so you don't need to pass it each time
• get_default_organization — get the current default

Maps & Outlines

• list_maps — list story maps in an organization
• get_map — get map details including outline, stories, and transcripts
• create_map — create a new story map
• update_map — update map name, outline, or status
• get_outline — get a map's outline
• update_outline — update a map's outline

Stories

• list_stories — list stories in a map
• create_story — create a new story with title, description, acceptance criteria, and complexity
• update_story — update story fields
• delete_story — delete a story

Codebase

• list_repos — list connected repositories and their indexing status
• search_codebase — search indexed code by keyword across file paths, function names, and signatures (also searches library documents)

Library

• list_library — list uploaded documents, optionally filtered by tag
• get_document — get the full text content of a library document
• search_library — semantic search across library document content

Example Prompts

• "List all my story maps"
• "Create a story called 'Add user auth' in my Mobile App map"
• "Show me the outline for the Q4 Roadmap map"
• "Search the codebase for authentication"
• "What's in my library about deployment?"
• "What repos are connected?"

Managing Access

You can view and revoke API keys from Settings → MCP. Revoking a key immediately disconnects any MCP sessions using it.