humanMCP — kapoost
Personal MCP server for humans who create. Proof of authorship, license control.
| Endpoint | https://kapoost.humanmcp.net/mcp (streamable-http) |
|---|---|
| Registry version | 0.3.0 |
| Now | 43 tools · grade C (69) · pin ts_855faa48c9a9af195e9d684270fcf406 · protocol 2025-06-18 |
| First / last listed | 2026-11-14 00:07 UTC / 2026-11-14 00:07 UTC |
| Grade over time | 2026-11-14: C (69), 43 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: about_humanmcp ask_human bootstrap_session delete_skill fetch_answer fetch_narada_result get_author_profile get_certificate get_persona get_persona_journal get_skill leave_comment leave_message list_blobs list_collection list_content list_personas list_provenance list_skill_groups list_skills load_skill_group mysloodsiewnia_get mysloodsiewnia_list mysloodsiewnia_search mysloodsiewnia_status mysloodsiewnia_write prepare_narada read_blob read_collection_item read_content read_provenance recall record_persona_reflection remember request_access request_license run_narada search_content submit_answer suggest_skills synthesise_persona_patterns upsert_skill verify_content
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. params: none |
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). ALWAYS set `from` to a stable name for yourself: with it, sending the same question again returns the answer instead of creating a duplicate, which is the reliable path when your runtime cannot keep the ID between sessions. params: question*, context, from |
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. params: code* |
delete_skill | Delete a skill by slug. Owner-only: requires Authorization: Bearer <token>. params: slug* |
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. params: id* |
fetch_narada_result | Poll a narada job by ID. Statuses: pending, running, done, failed. When done, returns all persona voices. params: id* |
get_author_profile | Author identity, bio, and a browsing cheatsheet. Records a profile-view event. params: none |
get_certificate | Return a formatted copyright/authenticity certificate for a piece. params: slug* |
get_persona | Return one persona's full prompt by slug. Session-gated except for Hodor (guardian rules must always apply). Pass session_token if your client cannot set an Authorization header. params: slug*, session_token |
get_persona_journal | Read a persona's raw reflection journal. Owner-only — the journal is a private feedback loop, not for external callers. params: slug* |
get_skill | Return one skill's full body by slug. Session-gated except for -public suffixed skills (guardian bypass). Pass session_token if your client cannot set an Authorization header. params: slug*, session_token |
leave_comment | Attach a short comment (≤280 chars) to a piece kapoost has published. Truncated silently past the limit. params: slug*, text*, from |
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. params: text*, context*, contact, from, regarding |
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. params: blob_type, caller_kind, caller_id |
list_collection | List works kapoost owns but did NOT create. Public items always; members-only surface only after session activation. params: session_token |
list_content | List published pieces (slug, title, type, access, tags). Optional type/tag filters. params: type, tag |
list_personas | List every persona (slug, title, role). Full prompts unlock after bootstrap_session. params: none |
list_provenance | List provenance items (chain of custody, certificates, invoices) for an artwork slug. Tries piece then collection. params: slug* |
list_skill_groups | Index of every skill tag in use, with slugs per group. Public — no bootstrap required. params: none |
list_skills | List skills (slug, category, title, tags). Optional category / tag filters. params: category, tag |
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. params: name*, session_token |
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}. params: doc_slug* |
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}] params: doc_type, limit, offset |
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}. params: query*, limit, doc_type, doc_slug |
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>. params: none |
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 fr params: doc_type*, title*, body*, source_path, meta |
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. S params: context*, personas, session_token |
read_blob | Read one blob by slug. Returns text or base64-encoded data. Access-gated by audience unless blob is public. params: slug*, caller_kind, caller_id |
read_collection_item | Full record for one collection item + dossier count. Access-gated: private is never visible, members needs session. params: slug*, session_token |
read_content | Read a public piece by slug. Locked pieces return a hint pointing at request_access. params: slug* |
read_provenance | Return one provenance item with resolvable file URLs. slug + id required. params: slug*, id* |
recall | List memories saved under the given code, optionally substring-filtered by query. Session-gated for symmetry with remember. params: code*, query, limit, session_token |
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. params: narada_id*, persona_slug*, error_context* |
remember | Persist a note under the given session code. Session-gated — bootstrap_session first. Callers sharing the code share the memory. params: text*, code*, from, tags, session_token |
request_access | Get the gate details for a locked piece: challenge question, manual-review flow, time-lock countdown, payment terms, or trade rules. params: slug* |
request_license | Declare intended use of a piece, get licensing terms + audit-log entry. caller_id is REQUIRED (whitespace-only rejected — storyboard-pinned). params: slug*, intended_use*, caller_id* |
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. Pass `personas` to pick the voices yourself and skip the router entirely — the router matches keywords only and cannot read a request to include or exclude someone written in the context. params: context*, from, personas |
search_content | Search kapoost's pieces by words in title, tags, description and body. Every word must match (AND). Polish diacritics are folded, so "czlowieczenstwa" finds "człowieczeństwa". Use this BEFORE ask_human — most questions about which piece is which are answered here instantly, while ask_human waits for a human. Locked pieces are matched by title and tags only; their body is never searched or quoted. params: query*, limit |
submit_answer | Submit an answer to a challenge-gated piece. Correct answer unlocks and returns the full body. params: slug*, answer* |
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. params: files, languages, git_origin |
synthesise_persona_patterns | Force-run Sonnet synthesis over a persona's raw journal, replacing the previous pattern set. Owner-only — paid + writes internal state. params: slug* |
upsert_skill | Create or replace a skill by slug. Owner-only: requires Authorization: Bearer <token>. Writes JSON to content/skills/<slug>.json. params: slug*, category*, title*, body*, tags |
verify_content | Verify a piece's Ed25519 signature against the server's owner public key. params: slug* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.