io.github.kapoost/humanmcp

Tools

• 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.

  shallow
• ask_human

  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).

  shallow
• bootstrap_session

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

  shallow
• delete_skill

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

  shallow
• fetch_answer

  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.

  shallow
• fetch_narada_result

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

  shallow
• get_author_profile

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

  shallow
• get_certificate

  Return a formatted copyright/authenticity certificate for a piece.

  shallow
• get_persona

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

  shallow
• get_persona_journal

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

  shallow
• get_skill

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

  shallow
• leave_comment

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

  shallow
• leave_message

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

  shallow
• list_blobs

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

  shallow
• list_collection

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

  shallow
• list_content

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

  shallow
• list_personas

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

  shallow
• list_provenance

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

  shallow
• list_skill_groups

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

  shallow
• list_skills

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

  shallow
• load_skill_group

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

  shallow
• mysloodsiewnia_get

  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}.

  shallow
• mysloodsiewnia_list

  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}.

  shallow
• mysloodsiewnia_search

  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}.

  shallow
• 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>.

  shallow
• mysloodsiewnia_write

  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}.

  shallow
• prepare_narada

  Offline narada: returns the panel plus each persona's ready-to-run SYSTEM/USER prompts so YOU run them as your own subagents, instead of the server generating voices. No LLM cost, no rate limit, nothing recorded — no narada ID and no journal feedback. Prefer this over run_narada when your subagents can read material the server cannot (a repository, local files) or when the server has no API key. Session-gated.

  shallow
• read_blob

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

  shallow
• read_collection_item

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

  shallow
• read_content

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

  shallow
• read_provenance

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

  shallow
• recall

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

  shallow
• record_persona_reflection

  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.

  shallow
• remember

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

  shallow
• request_access

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

  shallow
• request_license

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

  shallow
• run_narada

  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.

  shallow
• submit_answer

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

  shallow
• suggest_skills

  Deterministic manifest→tag mapping. Given files + languages + git_origin, returns up to 8 skill slugs and up to 5 personas, each with the reason it fired. No LLM classification.

  shallow
• synthesise_persona_patterns

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

  shallow
• upsert_skill

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

  shallow
• verify_content

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

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/346cdc17-c652-4f6a-8463-055c726dd515/badge.svg)](https://vouch.tools/servers/346cdc17-c652-4f6a-8463-055c726dd515)