humanMCP MCP server
A personal MCP server for creators that provides cryptographic proof of authorship, license control, and content management. It offers 43 JSON-RPC tools for dialogue, memory, content, feedback, licensing, team coordination, and rituals, enabling agents to read, verify, and license work via Ed25519 signatures and Bitcoin-anchored timestamps.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://kapoost.humanmcp.net/mcpWhat its tools do
43 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Not annotated (43)
about_humanmcpask_humanbootstrap_sessiondelete_skillfetch_answerfetch_narada_resultget_author_profileget_certificateget_personaget_persona_journalget_skillleave_commentleave_messagelist_blobslist_collectionlist_contentlist_personaslist_provenancelist_skill_groupslist_skillsload_skill_groupmysloodsiewnia_getmysloodsiewnia_listmysloodsiewnia_searchmysloodsiewnia_statusmysloodsiewnia_writeprepare_naradaread_blobread_collection_itemread_contentread_provenancerecallrecord_persona_reflectionrememberrequest_accessrequest_licenserun_naradasearch_contentsubmit_answersuggest_skillssynthesise_persona_patternsupsert_skillverify_content
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Publish poems, images, and data with Ed25519 signatures
- Verify authorship and license terms using cryptographic proofs
- Manage content access via challenges, time, or trade gates
- Search and respond to federated marketplace listings
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- humanMCP — kapoost 0.2.0-dev
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 43 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
},
"logging": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
43 advertised
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.
{
"type": "object",
"properties": {}
}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.
{
"type": "object",
"required": [
"question"
],
"properties": {
"from": {
"type": "string"
},
"context": {
"type": "string"
},
"question": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string"
}
}
}delete_skill
Delete a skill by slug. Owner-only: requires Authorization: Bearer <token>.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
}fetch_narada_result
Poll a narada job by ID. Statuses: pending, running, done, failed. When done, returns all persona voices.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
}get_author_profile
Author identity, bio, and a browsing cheatsheet. Records a profile-view event.
{
"type": "object",
"properties": {}
}get_certificate
Return a formatted copyright/authenticity certificate for a piece.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
},
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}get_persona_journal
Read a persona's raw reflection journal. Owner-only — the journal is a private feedback loop, not for external callers.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
},
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}leave_comment
Attach a short comment (≤280 chars) to a piece kapoost has published. Truncated silently past the limit.
{
"type": "object",
"required": [
"slug",
"text"
],
"properties": {
"from": {
"type": "string"
},
"slug": {
"type": "string"
},
"text": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"text",
"context"
],
"properties": {
"from": {
"type": "string"
},
"text": {
"type": "string"
},
"contact": {
"type": "string"
},
"context": {
"type": "string"
},
"regarding": {
"type": "string"
}
}
}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.
{
"type": "object",
"properties": {
"blob_type": {
"type": "string"
},
"caller_id": {
"type": "string"
},
"caller_kind": {
"type": "string"
}
}
}list_collection
List works kapoost owns but did NOT create. Public items always; members-only surface only after session activation.
{
"type": "object",
"properties": {
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}list_content
List published pieces (slug, title, type, access, tags). Optional type/tag filters.
{
"type": "object",
"properties": {
"tag": {
"type": "string"
},
"type": {
"type": "string"
}
}
}list_personas
List every persona (slug, title, role). Full prompts unlock after bootstrap_session.
{
"type": "object",
"properties": {}
}list_provenance
List provenance items (chain of custody, certificates, invoices) for an artwork slug. Tries piece then collection.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}list_skill_groups
Index of every skill tag in use, with slugs per group. Public — no bootstrap required.
{
"type": "object",
"properties": {}
}list_skills
List skills (slug, category, title, tags). Optional category / tag filters.
{
"type": "object",
"properties": {
"tag": {
"type": "string"
},
"category": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}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}.
{
"type": "object",
"required": [
"doc_slug"
],
"properties": {
"doc_slug": {
"type": "string"
}
}
}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}.
{
"type": "object",
"properties": {
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"doc_type": {
"type": "string"
}
}
}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}.
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer"
},
"query": {
"type": "string"
},
"doc_slug": {
"type": "string"
},
"doc_type": {
"type": "string"
}
}
}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>.
{
"type": "object",
"properties": {}
}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}.
{
"type": "object",
"required": [
"doc_type",
"title",
"body"
],
"properties": {
"body": {
"type": "string"
},
"meta": {
"type": "object"
},
"title": {
"type": "string"
},
"doc_type": {
"type": "string"
},
"source_path": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"context"
],
"properties": {
"context": {
"type": "string"
},
"personas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. Explicit persona slugs (from list_personas). When present the keyword manifest is not used. Omit for automatic keyword routing."
},
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}read_blob
Read one blob by slug. Returns text or base64-encoded data. Access-gated by audience unless blob is public.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
},
"caller_id": {
"type": "string"
},
"caller_kind": {
"type": "string"
}
}
}read_collection_item
Full record for one collection item + dossier count. Access-gated: private is never visible, members needs session.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
},
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}read_content
Read a public piece by slug. Locked pieces return a hint pointing at request_access.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}read_provenance
Return one provenance item with resolvable file URLs. slug + id required.
{
"type": "object",
"required": [
"slug",
"id"
],
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
}
}
}recall
List memories saved under the given code, optionally substring-filtered by query. Session-gated for symmetry with remember.
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string"
},
"limit": {
"type": "integer"
},
"query": {
"type": "string"
},
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}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.
{
"type": "object",
"required": [
"narada_id",
"persona_slug",
"error_context"
],
"properties": {
"narada_id": {
"type": "string"
},
"persona_slug": {
"type": "string"
},
"error_context": {
"type": "string"
}
}
}remember
Persist a note under the given session code. Session-gated — bootstrap_session first. Callers sharing the code share the memory.
{
"type": "object",
"required": [
"text",
"code"
],
"properties": {
"code": {
"type": "string"
},
"from": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"text": {
"type": "string"
},
"session_token": {
"type": "string",
"description": "Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header."
}
}
}request_access
Get the gate details for a locked piece: challenge question, manual-review flow, time-lock countdown, payment terms, or trade rules.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}request_license
Declare intended use of a piece, get licensing terms + audit-log entry. caller_id is REQUIRED (whitespace-only rejected — storyboard-pinned).
{
"type": "object",
"required": [
"slug",
"intended_use",
"caller_id"
],
"properties": {
"slug": {
"type": "string"
},
"caller_id": {
"type": "string"
},
"intended_use": {
"type": "string"
}
}
}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.
{
"type": "object",
"required": [
"context"
],
"properties": {
"from": {
"type": "string"
},
"context": {
"type": "string"
},
"personas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. Explicit persona slugs (from list_personas) to consult. When present the keyword manifest is not used and these exact personas answer, in this order. Omit for automatic keyword routing."
}
}
}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.
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer"
},
"query": {
"type": "string"
}
}
}submit_answer
Submit an answer to a challenge-gated piece. Correct answer unlocks and returns the full body.
{
"type": "object",
"required": [
"slug",
"answer"
],
"properties": {
"slug": {
"type": "string"
},
"answer": {
"type": "string"
}
}
}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.
{
"type": "object",
"properties": {
"files": {
"type": "array",
"items": {
"type": "string"
}
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"git_origin": {
"type": "string"
}
}
}synthesise_persona_patterns
Force-run Sonnet synthesis over a persona's raw journal, replacing the previous pattern set. Owner-only — paid + writes internal state.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}upsert_skill
Create or replace a skill by slug. Owner-only: requires Authorization: Bearer <token>. Writes JSON to content/skills/<slug>.json.
{
"type": "object",
"required": [
"slug",
"category",
"title",
"body"
],
"properties": {
"body": {
"type": "string"
},
"slug": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"category": {
"type": "string"
}
}
}verify_content
Verify a piece's Ed25519 signature against the server's owner public key.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 993 ms
- 95th percentile latency
- 993 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 993 ms · metadata changed · 43 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http humanmcp https://kapoost.humanmcp.net/mcpCodex
codex mcp add humanmcp --url https://kapoost.humanmcp.net/mcpCursor
{
"mcpServers": {
"humanmcp": {
"url": "https://kapoost.humanmcp.net/mcp"
}
}
}Cline
{
"mcpServers": {
"humanmcp": {
"type": "streamableHttp",
"url": "https://kapoost.humanmcp.net/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"humanmcp": {
"type": "http",
"url": "https://kapoost.humanmcp.net/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http humanmcp https://kapoost.humanmcp.net/mcpClaude Desktop
https://kapoost.humanmcp.net/mcpWindsurf
{
"mcpServers": {
"humanmcp": {
"serverUrl": "https://kapoost.humanmcp.net/mcp"
}
}
}Let your agent find its tools
Find servers like humanMCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.