Harper MCP

Guidelines for exposing a Harper instance as a Model Context Protocol (MCP) server and for building the tools, prompts, and resources AI clients consume. Harper implements MCP Streamable HTTP (spec rev 2025-06-18) with two independent profiles: application (your app's surface) and operations (Harper administration).

When to Use

Reference these guidelines when:

• Enabling or configuring the MCP endpoint on a Harper instance
• Connecting an MCP client (Claude, agent frameworks, custom HTTP code) to Harper
• Deciding what tools an AI should see for a schema, or trimming that surface
• Exposing custom behavior (mcpTools), prompt templates (mcpPrompts), or content (mcpResources) to AI clients
• Protecting a public or anonymous-accessible MCP endpoint (rate limits, durable quotas, hardening)
• Debugging MCP wire errors (session/protocol headers, 400s, SSE)

How It Works