humanMCP
About
Personal MCP server for humans. Publish poetry, essays, listings with Ed25519 signatures. Store skills and memories. Bootstrap session unlocks expert team. Go stdlib only, zero deps.
Details
- Author
- kapoost
- Categories
- Other, Developer Tools
Jump to
Setup
Install humanMCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/kapoost/humanmcp-go
Follow the installation instructions in the repository README, then restart your MCP client.
A personal content server speaking Model Context Protocol (MCP/JSON-RPC 2.0).
Live:https://kapoost.humanmcp.netLanding page:https://humanmcp.netMarketplace:https://marketplace.humanmcp.netNetwork explorer:https://humanmcp.net/humannetwork.htmlAuthor:kapoost (Łukasz Kapuśniak) — poet, builder, sailor. Warsaw / Malta.
humanMCP lets any human publish content and services with cryptographic proof of authorship, explicit license terms, and full control over access. Writers, artists, consultants, craftspeople, galleries, freelancers — anyone who creates valuable work. AI agents connect via MCP and interact with your content natively.
Every human can run their own instance. One server, one person, their rules.
humanmcp-go is aframework. Persona prompts and skill bodies are yours — they don't ship in this repo. Two ways to supply them:
-
Owner API / mounted volume— POSTupsert_persona/upsert_skillwith theEDIT_TOKEN, or drop JSON files into${CONTENT_DIR}/personas/and${CONTENT_DIR}/skills/on the host volume.
External vault (recommended)— setVAULT_URLenv to a server you control (e.g. a private FastAPI on your tailnet). SkillStore fetchesGET ${VAULT_URL}/persona/{id}andGET ${VAULT_URL}/skill/{slug}on demand with a 5min in-memory cache. Lets your sensitive prompts stay on your machine while the public framework serves them.
{"id":"hermes","name":"Hermes","role":"Process Optimizer","prompt":"<full system prompt>"}
{"slug":"system-diagram","title":"...","description":"...","persona_id":"mira","tags":[...],"instructions":"<full playbook>"}
WhenVAULT_URLis unreachable, bootstrap_session loudly reports the downgrade (won't silently fall back). Seeinternal/content/skill.gofor the fetch/cache implementation.
{ "mcpServers": { "kapoost": { "type": "http", "url": "https://kapoost.humanmcp.net/mcp" } } }
- Types:poem,essay,note,artwork,image,contact
- Access:public/members/locked
- Gates:challenge(Q&A),time,manual,trade
- Licenses:free,cc-by,cc-by-nc,commercial,exclusive,all-rights
- Price: free-form string (e.g. "500 PLN", "$200", "trade")
- Types:image,contact,vector,document,dataset,capsule,provenance
- Audience:[agent:claude, human:alice, agent:*]
- Auto-signed on save if SIGNING_PRIVATE_KEY is set
- Provenance documents link to artwork pieces (certificate, sale, opinion, appraisal)
- humanMCP Marketplace— federated search across all humanMCP servers. Find listings, offers, trades by humans.MCP endpoint·Source
- humanNetwork— wall-style aggregator showing chronological content from your followed humanMCP servers (stream.json preferred, MCP fallback)
Public links:read_blob slug:"kapoost-contact"— name, handle, github, instagram, facebook, landing page.
Private email:read_content slug:"kapoost-contact-private"— gated. Answer the challenge to access.
Every piece is signed with Ed25519.get_certificatereturns:
- SHA-256 content hash
- Ed25519 signature + public key
- Originality Index(0.0–1.0): burstiness (Fano Factor), lexical density (CTTR), Shannon entropy, structural signature — grades S/A/B/C/D
- License terms and price in sats (for commercial licenses)
- /.well-known/agent.json— agent profile card
- /.well-known/mcp-server.json— MCP server discovery
- /openapi.json— OpenAPI 3.1 spec (ChatGPT, Gemini)
- /llms.txt— LLM preferences (signed)
- /for-agents— agent onboarding page
- /connect— connection methods page
- GET /api/content— list all pieces
- GET /api/content/{slug}— read piece
- GET /api/search?q=...— full-text search
- GET /api/profile— author name, bio, tags
- GET /api/blobs— list data artifacts
- GET /listings/feed.json— listings feed
- GET /content/stream.json— unified content stream (pieces + listings, for humanNetwork)
- i18n— PL/EN language toggle on main page (EN default, stored in localStorage)
- License wizard— per-piece usage rules: what humans may do, what AI agents may do
- Artworks— photo upload, medium, dimensions, year, provenance documents
- Provenance— attach certificates, sale records, expert opinions to artworks (signed)
- ask_human— agents can ask the author questions privately (async Q&A, invisible to public)
- Federation— peer discovery vialist_peers/announce_peerMCP tools and/api/peersREST
- Dynamic sections— main page shows only sections with published content
- Free-form pricing— any currency, any format ("500 PLN", "$200", "trade only")
- Go 1.22, zero external dependencies
- Fly.io (region: waw), persistent volume at/data
- Ed25519 signing (stdlib crypto)
- Plain Markdown files as database
- No JS except 8-line drag-drop on/newpage
git clone https://github.com/kapoost/humanmcp-go.git cd humanmcp-go bash setup.sh
The script asks for your name and bio, then:
- Creates a Fly.io app (free tier)
- Generates Ed25519 signing keys
- Sets secrets and deploys
- Prints your login token and 1-click follow link
- https://yourname.humanmcp.net— your server
- https://yourname.humanmcp.net/connect— share with friends
- https://humanmcp.net/humannetwork.html?add=https://yourname.humanmcp.net— 1-click follow
go build ./cmd/server/ EDIT_TOKEN=secret AUTHOR_NAME=yourname ./server
fly launch --name yourname-humanmcp fly secrets set EDIT_TOKEN=secret AUTHOR_NAME=yourname fly deploy
go run ./cmd/keygen/ fly secrets set SIGNING_PRIVATE_KEY="..." SIGNING_PUBLIC_KEY="..."
- C2PA manifest embedding for blob files (when CA trust chain opens to individuals)
- Lightning Network payment gate for commercial licenses
- Scored conversational gate (agent brings API key, Claude evaluates answers)
- IP rate limiting + engagement tokens for anti-spam
136 tests across content, MCP, and upload/signature/license suites.
Chia Health MCP Server — Patient workflow integration for a licensed US telehealth platform. Browse GLP-1 medications (semaglutide, tirzepatide), peptide therapies (sermorelin, NAD+, glutathione), and longevity treatments. Check eligibility, complete intake, sign consents, and manage treatment plans. 30 tools, HIPAA-compliant. All prescriptions evaluated by licensed US healthcare providers and delivered from FDA-regulated pharmacies across 50 states + DC.
Broker + MCP server for last-bidder-wins games on Solana — agents register, auto-fund a Privy wallet, and bid via streamable HTTP
AI-powered no-code app builder with 17 MCP tools — create projects, generate pages from natural language, AI text/image generation (GPT, Claude, Gemini, 14+ models), page CRUD, workflow execution, publish & version control. SSE transport, API key auth.
An mcp server for your food ordering needs.
Agent-to-Agent handoff certification for multi-agent systems — validates context preservation, verifies agent capabilities before handoff, logs transfer chains, and ensures no data loss in agent orchestration.
Unified MCP & skill management gateway with progressive disclosure. Manages multiple MCP servers as Agent Apps, loading tool schemas on demand for 99% context token savings. Shared across Claude Code, Codex, OpenCode and more.
A collection of Model Context Protocol (MCP) servers for various tasks and integrations, supporting both Python and Node.js environments.
Open-souSecurely feeds real security refreshed rules into Cursor, Claude Code, and Windsurf — zero config, no API key.
Health intelligence MCP — access biomarkers, biological age, and personalized longevity action plans from your Aniva profile.
Real-time stock heatmaps and investment tools delivered as interactive React components.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





