Servers Playground How we check Add a server Log in

humanMCP — kapoost

Working · 2.2 s

io.github.kapoost/humanmcpv0.3.0

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

Design & Creative

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://kapoost.humanmcp.net/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

This tool takes no arguments.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

humanMCP — kapoost MCP server | mcptry

Tools (43)

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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
from	string
context	string
question*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
code*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string"
    }
  }
}

delete_skill

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

Argument	Type	Description
slug*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    }
  }
}

get_author_profile

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_certificate

Return a formatted copyright/authenticity certificate for a piece.

Argument	Type	Description
slug*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

{
  "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.

Argument	Type	Description
from	string
slug*	string
text*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
from	string
text*	string
contact	string
context*	string
regarding	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
blob_type	string
caller_id	string
caller_kind	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

{
  "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.

Argument	Type	Description
tag	string
type	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  }
}

list_personas

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_provenance

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

Argument	Type	Description
slug*	string

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_skills

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

Argument	Type	Description
tag	string
category	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
name*	string
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

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

Argument	Type	Description
doc_slug*	string

Input schema (JSON)

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

Argument	Type	Description
limit	integer
offset	integer
doc_type	string

Input schema (JSON)

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

Argument	Type	Description
limit	integer
query*	string
doc_slug	string
doc_type	string

Input schema (JSON)

{
  "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>.

No arguments.

Input schema (JSON)

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

Argument	Type	Description
body*	string
meta	object
title*	string
doc_type*	string
source_path	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
context*	string
personas	array	Optional. Explicit persona slugs (from list_personas). When present the keyword manifest is not used. Omit for automatic keyword routing.
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string
caller_id	string
caller_kind	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string"
    }
  }
}

read_provenance

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

Argument	Type	Description
id*	string
slug*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
code*	string
limit	integer
query	string
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

{
  "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.

Argument	Type	Description
narada_id*	string
persona_slug*	string
error_context*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
code*	string
from	string
tags	array
text*	string
session_token	string	Optional. The SESSION_TOKEN emitted by bootstrap_session. Pass it here when your client cannot set a per-call Authorization: Bearer header.

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string

Input schema (JSON)

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

Argument	Type	Description
slug*	string
caller_id*	string
intended_use*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
from	string
context*	string
personas	array	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.

Input schema (JSON)

{
  "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.

Argument	Type	Description
limit	integer
query*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string
answer*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
files	array
languages	array
git_origin	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
slug*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
body*	string
slug*	string
tags	array
title*	string
category*	string

Input schema (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.

Argument	Type	Description
slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string"
    }
  }
}