harper-mcp — Claude Code skill: setup and installation
This Claude Code skill covers Harper MCP server setup and client connections. It activates for tasks involving Harper tools, resources, prompts, or endpoint security.
Apache-2.0 114 installs ★ 3 updated 2026-10-24
npx skills add HarperFast/skills --skill harper-mcp -a claude-codeWhat harper-mcp does
The skill explains how to enable a Harper MCP server and connect a client, including the initialization handshake, session and protocol headers, and authentication. It also covers generated CRUD tools for exported tables, plus custom tools, prompts, and resources.
Other sections describe request rate limits, durable quotas, and safeguards for public endpoints. The application and operations profiles are independent: one exposes an app’s interface, while the other covers Harper administration. The repository includes rule files under rules/ and a compiled guide in AGENTS.md.
What it helps with
- enable an MCP profile on a Harper instance
- connect an MCP client with the required headers and authentication
- configure generated CRUD tools for exported tables
- publish custom tools, prompts, or resources
- limit MCP calls and secure a public endpoint
Example prompts for the agent
- Set up the Harper MCP server and connect an MCP client.
- Show the generated CRUD tools available for Harper tables.
- How do I limit MCP tool calls and secure a public Harper endpoint?
How to install harper-mcp
1Skills CLI (Vercel)
npx skills add HarperFast/skills --skill harper-mcp -a claude-code2Manually: put the files in place
~/.claude/skills/harper-mcp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/harper-mcp/
1Skills CLI (Vercel)
npx skills add HarperFast/skills --skill harper-mcp -a codex2Manually: put the files in place
.agents/skills/harper-mcp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add HarperFast/skills --skill harper-mcp -a cursor2Manually: put the files in place
.cursor/skills/harper-mcp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install HarperFast/skills harper-mcp2Manually: put the files in place
.github/skills/harper-mcp/SKILL.md1Skills CLI (Vercel)
npx skills add HarperFast/skills --skill harper-mcp -a gemini-cli2Platform CLI
gemini skills install https://github.com/HarperFast/skills --path harper-mcpManually: put the files in place
.devin/skills/harper-mcp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add HarperFast/skills --skill harper-mcp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about harper-mcp
How do I install harper-mcp in Claude Code?
Run npx skills add HarperFast/skills --skill harper-mcp -a claude-code. The skill file is at ~/.claude/skills/harper-mcp/SKILL.md.
What does harper-mcp do?
It documents Harper MCP server setup and client connections, along with ways to expose tools, prompts, and resources. It also covers rate limits and security.
Which MCP profiles does Harper provide?
Harper has two independent profiles: application for an app’s interface and operations for Harper administration.
Source text
SKILL.md · Apache-2.0
--- name: harper-mcp description: Comprehensive guide to Harper's Model Context Protocol (MCP) interface, covering server setup, client connection, automatic and custom tools, prompts, resources, rate limiting, durable quotas, and the security model. Triggers on tasks involving MCP servers on Harper, AI-client integration, and exposing Harper data or behavior to LLM agents. license: Apache-2.0 metadata: author: harper version: '1.0.0' --- # 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 1. Start with `enabling-mcp` to mount a profile, then `connecting-clients` for the handshake contract. 2. For the tool surface, consult `automatic-verb-tools` first — most CRUD needs are covered with zero code — and reach for `custom-mcp-tools` only for real behavior. 3. For content and templates, use `custom-mcp-resources` and `custom-mcp-prompts`; `resources-surface` explains what exists without any code. 4. Before any public exposure, work through `security-posture`'s checklist and configure `rate-limiting` (+ `durable-quotas` for cost-bearing tools). ## Examples See the concrete examples embedded in each rule (curl handshakes, `static mcpTools`/`mcpResources` declarations, quota-hook implementations, and hardening configs). <!-- BEGIN GENERATED INDEX --> ## Rule Categories by Priority | Priority | Category | Impact | Prefix | | -------- | --------------------- | ------ | ------------ | | 1 | Setup & Connection | HIGH | `setup-` | | 2 | Tools & Prompts | HIGH | `tools-` | | 3 | Resources | MEDIUM | `resources-` | | 4 | Operations & Security | HIGH | `ops-` | ## Quick Reference ### 1. Setup & Connection (HIGH) - `enabling-mcp` — How to enable and configure Harper's MCP server profiles (application and operations). - `connecting-clients` — How MCP clients connect to Harper - the initialize handshake, session and protocol-version headers, and authentication. ### 2. Tools & Prompts (HIGH) - `automatic-verb-tools` — How Harper auto-generates CRUD MCP tools from exported tables, with RBAC filtering and allow/deny/maxTools controls. - `custom-mcp-tools` — How to expose custom instance methods as MCP tools via static mcpTools, including the anonymous-exposure security model. - `custom-mcp-prompts` — How to publish reusable prompt templates to MCP clients via static mcpPrompts. ### 3. Resources (MEDIUM) - `resources-surface` — The MCP resources surface - harper:// metadata URIs, harper+rest:// table descriptors, templates, subscriptions, and list_changed notifications. - `custom-mcp-resources` — How to serve custom content (docs pages, reports, binaries) as MCP resources via static mcpResources with URI templates and completions. ### 4. Operations & Security (HIGH) - `rate-limiting` — MCP tools/call rate limiting - per-tool, per-session, and per-client-identity token buckets, and the identityHeader trust model. - `durable-quotas` — Operator-pluggable durable quotas for MCP tools/call via the server.setMcpQuotaHandler registration hook, with a race-safe counter pattern. - `security-posture` — The MCP security model - anonymous access, RBAC boundaries, origin validation, audit logging, and the hardening checklist for public instances. <!-- END GENERATED INDEX --> ## How to Use Read individual rule files for detailed explanations and code examples: ``` rules/enabling-mcp.md rules/connecting-clients.md rules/custom-mcp-tools.md rules/custom-mcp-resources.md rules/security-posture.md ``` ## Full Compiled Document For the complete guide with all rules expanded: `AGENTS.md`
© harper · Apache-2.0 · HarperFast/skills