# humanMCP [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/kapoost/humanmcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/humanmcp

## Description
Personal MCP server for publishing art with cryptographic authorship proof and license gates.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "humanmcp": {
    "url": "https://kapoost-humanmcp.fly.dev"
  }
}
```

## Documentation & README

# humanMCP

A personal content server speaking Model Context Protocol (MCP/JSON-RPC 2.0).

**Live:** https://kapoost-humanmcp.fly.dev  
**Landing page:** https://kapoost.github.io/humanmcp  
**Author:** kapoost (Łukasz Kapuśniak) — poet, builder, sailor. Warsaw / Malta.

## What it is

humanMCP lets you publish poems, essays, notes, images, and typed data artifacts with cryptographic proof of authorship, explicit license terms, and full control over who can access what. AI agents connect via MCP and interact with your content natively.

## MCP Tools (12)

| Tool | Description |
|---|---|
| `get_author_profile` | Who is kapoost — bio, content overview, how to browse |
| `list_content` | Browse all pieces with metadata, filter by type or tag |
| `read_content` | Read a piece — respects all access gates |
| `request_access` | Get gate details for locked content |
| `submit_answer` | Unlock challenge-gated content |
| `list_blobs` | Browse typed data artifacts |
| `read_blob` | Read image, contact, dataset, vector (respects audience) |
| `verify_content` | Verify Ed25519 signature |
| `get_certificate` | Full IP certificate: license, price, originality index, hash, signature |
| `request_license` | Declare intended use, get terms, logged for audit |
| `leave_comment` | Leave a reaction — visible in author dashboard |
| `leave_message` | Send a direct note (max 2000 chars, URLs welcome) |

## Connect

```json
{
  "mcpServers": {
    "kapoost": {
      "type": "http",
      "url": "https://kapoost-humanmcp.fly.dev/mcp"
    }
  }
}
```

## Content types

**Pieces** (Markdown files):
- Types: `poem`, `essay`, `note`, `contact`
- Access: `public` / `members` / `locked`
- Gates: `challenge` (Q&A), `time`, `manual`, `trade`
- Licenses: `free`, `cc-by`, `cc-by-nc`, `commercial`, `exclusive`, `all-rights`

**Blobs** (typed data artifacts):
- Types: `image`, `contact`, `vector`, `document`, `dataset`, `capsule`
- Audience: `[agent:claude, human:alice, agent:*]`
- Auto-signed on save if SIGNING_PRIVATE_KEY is set

## Contact

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.

## Intellectual property

Every piece is signed with Ed25519. `get_certificate` returns:
- 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)

## SEO / discovery

- `robots.txt` — `https://kapoost-humanmcp.fly.dev/robots.txt`
- `sitemap.xml` — `https://kapoost-humanmcp.fly.dev/sitemap.xml`
- `/.well-known/mcp-server.json` — MCP server discovery

## Limits

| Field | Limit |
|---|---|
| Message / comment text | 2000 chars |
| Blob inline text | 512 KB |
| File upload | 50 MB |
| Slug | 64 chars |
| Title | 256 chars |

## Stack

- 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 `/new` page

## Run locally

```bash
go build ./cmd/server/
EDIT_TOKEN=secret AUTHOR_NAME=yourname ./server
```

## Deploy

```bash
fly launch --name yourname-humanmcp
fly secrets set EDIT_TOKEN=secret AUTHOR_NAME=yourname
fly deploy
```

## Signing keys (optional but recommended)

```bash
go run ./cmd/keygen/
fly secrets set SIGNING_PRIVATE_KEY="..." SIGNING_PUBLIC_KEY="..."
```

## Future

- 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

## Tests

136 tests across content, MCP, and upload/signature/license suites.

```bash
go test ./...
```