mcp server

humanMCP — kapoost

Personal MCP server for humans who create. Proof of authorship, license control.

Description as published by the maintainer. Source

• version 0.3.0
• slowing

slowing — Registry entry last updated 2026-05-05.

What this server can do

41 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

about_humanmcp

Self-description of this humanMCP server. Deterministic, no bootstrap required — call this first to decide whether the rest of the API is relevant.

ask_human(from, context, question)

Submit an async question to kapoost. Returns an ID. Rate-limited 5/hr/IP. Poll fetch_answer later — kapoost answers on his own schedule (minutes, hours, or days). Required: question.

bootstrap_session(code)

Validate the Polish poetry session code, then emit the full team briefing (guardian + style + personas + skills + persist block). Rate-limited 5/min/IP. Required: code.

delete_skill(slug)

Delete a skill by slug. Owner-only: requires Authorization: Bearer <token>. Required: slug.

fetch_answer(id)

Poll for an answer to an ask_human question. Marks the question as fetched the first time an answer is returned. Rate-limited 30/hr/IP. Required: id.

fetch_narada_result(id)

Poll a narada job by ID. Statuses: pending, running, done, failed. When done, returns all persona voices. Required: id.

get_author_profile

Author identity, bio, and a browsing cheatsheet. Records a profile-view event.

get_certificate(slug)

Return a formatted copyright/authenticity certificate for a piece. Required: slug.

get_persona(slug)

Return one persona's full prompt by slug. Session-gated except for Hodor (guardian rules must always apply). Required: slug.

get_persona_journal(slug)

Read a persona's raw reflection journal. Owner-only — the journal is a private feedback loop, not for external callers. Required: slug.

get_skill(slug)

Return one skill's full body by slug. Session-gated except for -public suffixed skills (guardian bypass). Required: slug.

leave_comment(from, slug, text)

Attach a short comment (≤280 chars) to a piece kapoost has published. Truncated silently past the limit. Required: slug, text.

leave_message(from, text, contact, context, regarding)

Send kapoost a longer message. context REQUIRED (why you're writing / which piece / which task). contact optional — without it no reply is possible. Required: text, context.

list_blobs(blob_type, caller_id, caller_kind)

List typed data artifacts (images, contact, vectors, documents, datasets, capsules). Filter by blob_type. Readable-column reflects caller_kind + caller_id vs audience.

list_collection

List works kapoost owns but did NOT create. Public items always; members-only surface only after session activation.

list_content(tag, type)

List published pieces (slug, title, type, access, tags). Optional type/tag filters.

list_personas

List every persona (slug, title, role). Full prompts unlock after bootstrap_session.

list_provenance(slug)

List provenance items (chain of custody, certificates, invoices) for an artwork slug. Tries piece then collection. Required: slug.

list_skill_groups

Index of every skill tag in use, with slugs per group. Public — no bootstrap required.

list_skills(tag, category)

List skills (slug, category, title, tags). Optional category / tag filters.

load_skill_group(name)

Bulk-fetch every skill tagged with the given group name. Respects the bootstrap gate per-skill: -public suffix bypasses, everything else needs session. Required: name.

mysloodsiewnia_get(doc_slug)

Fetch one document from kapoost's vault by slug. Requires Authorization: Bearer <edit token or friend token>. Friend tokens: vault-side filter enforces scope + access:private invisibility — an out-of-scope or private slug returns not_found. Vault offline ⇒ {status:offline}. Required: doc_slug.

mysloodsiewnia_list(limit, offset, doc_type)

Enumerate vault documents without FTS — for browsing by type or paginating. Requires Authorization: Bearer <edit token or friend token>. Friend tokens see only their scoped doc_types; access:private is invisible. Args: {doc_type?: string filter (note/pdf/literatura/calendar_event/...), limit?: int 1-200 default 50, offset?: int default 0}. Returns [{slug, title, doc_type, created_at, chunk_count}]. Vault offline ⇒ {status:offline}.

mysloodsiewnia_search(limit, query, doc_slug, doc_type)

Full-text search (BM25 over SQLite FTS5) on kapoost's local vault corpus. Requires Authorization: Bearer <edit token or friend token>. Friend tokens see only their scoped doc_types; access:private is invisible. Returns {status, results:[{source, type, body, doc_slug, title, page, citation}], summary}. Vault offline ⇒ {status:offline}. Required: query.

mysloodsiewnia_status

Read-only liveness probe on kapoost's local vault (mysłoodsiewnia). Returns {status: online|degraded|offline, last_seen, commit_sha, personas_updated_at, skills_updated_at}. Offline is a stable state — retry later, don't escalate. Requires Authorization: Bearer <edit token or friend token>.

mysloodsiewnia_write(body, meta, title, doc_type, source_path)

Ingest a new document into kapoost's vault (wave 2). OWNER-ONLY — friend tokens receive {status:write_denied,reason:owner_only}. Args: {doc_type (required), title (required), body (required, ≤100 KiB), source_path?, meta?}. Requires Authorization: Bearer <owner token>. On Unauthorized: obtain the token by either (a) calling bootstrap_session(code=<owner poet fragment>) and reading SESSION_TOKEN from the response briefing (1h TTL, preferred for agents that already know the code), or (b) if you have shell access on kapoost's Mac, running `security find-generic-password -s humanmcp-edit-token -w` to fetch the persistent EDIT_TOKEN. Server-side vault auto-tags via:humanmcp-bridge; op_id is dedup key (idempotent retries safe). Delete is permanently unavailable. Envelopes: {status:online, op_id, result:{slug, created_at}}, {status:invalid_args}, {status:payload_too_large, limit, got}, {status:offline}, {status:vault_timeout}, {status:vault_error, error}. Required: doc_type, title, body.

read_blob(slug, caller_id, caller_kind)

Read one blob by slug. Returns text or base64-encoded data. Access-gated by audience unless blob is public. Required: slug.

read_collection_item(slug)

Full record for one collection item + dossier count. Access-gated: private is never visible, members needs session. Required: slug.

read_content(slug)

Read a public piece by slug. Locked pieces return a hint pointing at request_access. Required: slug.

read_provenance(id, slug)

Return one provenance item with resolvable file URLs. slug + id required. Required: slug, id.

recall(code, limit, query)

List memories saved under the given code, optionally substring-filtered by query. Session-gated for symmetry with remember. Required: code.

record_persona_reflection(narada_id, persona_slug, error_context)

Ask a persona to write a lesson-for-self after a rolled-back narada recommendation. Appends to the persona's journal via Sonnet/Haiku. Owner-only. Required: narada_id, persona_slug, error_context.

remember(code, from, tags, text)

Persist a note under the given session code. Session-gated — bootstrap_session first. Callers sharing the code share the memory. Required: text, code.

request_access(slug)

Get the gate details for a locked piece: challenge question, manual-review flow, time-lock countdown, payment terms, or trade rules. Required: slug.

request_license(slug, caller_id, intended_use)

Declare intended use of a piece, get licensing terms + audit-log entry. caller_id is REQUIRED (whitespace-only rejected — storyboard-pinned). Required: slug, intended_use, caller_id.

run_narada(from, context)

Create an async narada job: server routes context to 3-5 personas via keyword manifest, then generates each voice via Sonnet 4.6 (Haiku 4.5 for journal recaps). Returns job ID for polling. Required: context.

submit_answer(slug, answer)

Submit an answer to a challenge-gated piece. Correct answer unlocks and returns the full body. Required: slug, answer.

suggest_skills(files, languages, git_origin)

Deterministic manifest→tag mapping. Given files + languages + git_origin, returns up to 8 skill slugs with per-slug explanations. No LLM classification.

synthesise_persona_patterns(slug)

Force-run Sonnet synthesis over a persona's raw journal, replacing the previous pattern set. Owner-only — paid + writes internal state. Required: slug.

upsert_skill(body, slug, tags, title, category)

Create or replace a skill by slug. Owner-only: requires Authorization: Bearer <token>. Writes JSON to content/skills/<slug>.json. Required: slug, category, title, body.

verify_content(slug)

Verify a piece's Ed25519 signature against the server's owner public key. Required: slug.

Last successful function declaration observed on 2026-08-13. Source: https://kapoost.humanmcp.net/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://kapoost.humanmcp.net/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/kapoost/humanmcp-go
• Remote endpoint (streamable-http) — https://kapoost.humanmcp.net/mcp

Also from kapoost

• humanMCP Marketplace — federated listings across personal MCP servers
  Federated listings from personal humanMCP servers. Search offers, trades by humans.