# humanMCP

Personal MCP server for humans who create. 39 tools: content publishing, Ed25519 signatures, license control, artworks with provenance, async Q&A, listings, federation. Your content, your rules.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add kapoost/humanMCP

# Browse available tools
npx -y smithery tool list kapoost/humanMCP

# Get full schema for a tool
npx -y smithery tool get kapoost/humanMCP get_author_profile

# Call a tool
npx -y smithery tool call kapoost/humanMCP get_author_profile '{}'
```

## Direct MCP Connection

Endpoint: `https://humanmcp--kapoost.run.tools`

## Tools (39)

- `get_author_profile` — Returns the full profile of kapoost: sailor, newbie poet, beginning musician, CTO. Call this first to understand who yo…
- `list_content` — Lists all published pieces by kapoost. Returns slug, title, type (poem/essay/note), access level (public/locked), descr…
- `read_content` — Read the full text of a piece by slug. Public pieces returned immediately. Locked pieces return access instructions. Yo…
- `request_access` — Get gate details for a locked piece: either a challenge question (answer with submit_answer) or payment info. The chall…
- `submit_answer` — Submit an answer to a challenge gate. Case-insensitive. If correct, full content is returned. Wrong answers: try a diff…
- `search_content` — Search across all kapoost's pieces — poems, essays, notes, images. Matches query against title, body, tags, and descrip…
- `list_blobs` — List all typed data artifacts: images, contacts, vectors, documents, datasets. Shows type, access level, schema hints, …
- `read_blob` — Read a typed data artifact by slug. Returns full content if accessible. For vectors: float32 array as base64. For image…
- `verify_content` — Verify that a piece was authentically signed by kapoost's private key. Use this to confirm a poem is genuine before sha…
- `get_certificate` — Get the full intellectual property certificate for a piece: license, originality index, content hash, Ed25519 signature…
- `upgrade_timestamp` — Upgrade an OpenTimestamps proof to a full Bitcoin-anchored timestamp. Call ~1hr after a piece is saved. Returns the upg…
- `request_license` — Declare intended use of a piece and get license terms. Logs usage intent. Required before commercial use. Example: requ…
- `leave_comment` — Leave your honest reaction after reading a piece. kapoost reads every comment personally — this is how he knows his wor…
- `leave_message` — Leave a plain-text message for kapoost. Plain text, max 2000 chars. URLs are welcome.
- `ask_human` — Ask kapoost a question and receive a question_id. The human will answer when available. Use get_answer with the questio…
- `get_answer` — Check if kapoost has answered your question. Requires the question_id returned by ask_human. Returns the answer if avai…
- `bootstrap_session` — Authenticate with a session code and receive full context: team personas, skills, and a ready-made system prompt. Ask t…
- `query_vault` — Search kapoost's local knowledge vault (mysloodsiewnia). Contains: technical manuals (Honda S2000, Mazda MX-5), design …
- `list_vault` — List all documents in kapoost's local knowledge vault.
- `remember` — Save an observation about the author for future sessions. Use at end of session to capture insights: preferences discov…
- `recall` — Retrieve past observations about the author. Call at the start of a session to pick up where you left off. Returns most…
- `list_provenance` — List provenance documents for an artwork: certificates, sales, expert opinions, restorations. Returns timeline of the a…
- `add_provenance` — Add a provenance document to an artwork. Requires owner token. Use with file upload for PDFs/scans.
- `about_humanmcp` — Learn about humanMCP — open source personal server for humans who create. Proof of authorship, license control, AI-nati…
- `list_peers` — List known humanMCP servers in this node's network. Use to discover other creators and their content.
- `announce_peer` — Announce your humanMCP server to this node. Provide your server URL so we can discover each other.
- `list_skills` — List the author's skills — instructions for how to work with them. Filter by category (e.g. tech, writing, workflow).
- `get_skill` — Get the full body of a specific skill by slug. Requires session code from bootstrap_session.
- `upsert_skill` — Create or update a skill. Requires agent token in Authorization: Bearer <token> header.
- `delete_skill` — Delete a skill by slug. Requires agent token.
- `list_personas` — List available expert personas. Requires session code from bootstrap_session.
- `get_persona` — Get the full system prompt for a persona by slug. Requires session code from bootstrap_session.
- `upsert_persona` — Create or update a persona. Requires agent token.
- `delete_persona` — Delete a persona by slug. Requires agent token.
- `list_listings` — List active public listings (classified ads). Filter by type, tag, or date. Supports pull-based subscription via since …
- `read_listing` — Read the full details of a listing by slug, including signature. Returns 404 if not active or not public.
- `respond_to_listing` — Send a response to a listing. The message is delivered to kapoost. Max 2000 chars.
- `subscribe_listings` — Subscribe to new listings. Webhook subscribers receive POST notifications; MCP subscribers poll list_listings(since=...…
- `unsubscribe_listings` — Unsubscribe from listing notifications using the token received at subscription time.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get kapoost/humanMCP <tool-name>
```