humanMCP Marketplace β federated listings across personal MCP servers
Federated listings from personal humanMCP servers. Search offers, trades by humans.
Ask AI about humanMCP Marketplace β federated listings across personal MCP servers
Powered by Claude Β· Grounded in docs
I know everything about humanMCP Marketplace β federated listings across personal MCP servers. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
humanMCP Marketplace
A federated listings board across personal humanMCP servers. No accounts. No algorithms. Just humans and their offers.
Live: https://marketplace.humanmcp.net
MCP endpoint: POST https://marketplace.humanmcp.net/mcp
What it does
Every human can run their own humanMCP server β publishing listings, offers, and trades. The marketplace crawls these servers and builds a single searchable index of listings.
Think of it as a town square where every stall is independently owned. The marketplace doesn't host content β it indexes and links back to the origin.
Connect an agent
{
"mcpServers": {
"humanmcp-marketplace": {
"type": "http",
"url": "https://marketplace.humanmcp.net/mcp"
}
}
}
MCP Tools
| Tool | Description |
|---|---|
search_marketplace | Search listings across all servers β offers, trades, services |
list_servers | All registered humanMCP instances |
get_server | Server detail |
REST API
GET /servers β list all registered servers
GET /servers/{domain} β server detail
GET /search?q={query} β full-text search across all listings
GET /search?q=bread&type=trade β filter by listing type
GET /feed β recent listings feed (JSON)
POST /register β register a humanMCP instance
POST /mcp β MCP JSON-RPC 2.0 endpoint
Agent discovery
GET /.well-known/agent.json β agent profile card
GET /openapi.json β OpenAPI 3.1 spec
GET /healthz β status + server/listing counts
Web UI
GET / β homepage β listings + servers
GET /q?q={query} β search results
GET /s/{domain} β server page
Keyboard shortcuts: / search, j/k navigate, Enter open, d theme, ? help.
Register your server
Any humanMCP instance can join. No account needed β just your domain:
curl -X POST https://marketplace.humanmcp.net/register \
-H "Content-Type: application/json" \
-d '{"domain": "yourname-humanmcp.fly.dev"}'
The marketplace will:
- Verify it's a real humanMCP (fetches
/.well-known/agent.json) - Index all listings from
/listings/feed.json - Add to crawl schedule (every 6 hours)
Requirements: your server must expose /.well-known/agent.json and /listings/feed.json.
How crawling works
Your humanMCP server
β
Marketplace fetches /.well-known/agent.json (identity)
β
Fetches /api/profile (author name, bio, tags)
β
Fetches /listings/feed.json (listings)
β
Indexes in SQLite + FTS5
β
Searchable within minutes, re-crawled every 6 hours
Listings stay on your server. Marketplace keeps a search index only.
Configuration
| Source | Name | Default | Description |
|---|---|---|---|
| env | PORT | 8080 | Listen port |
| env | DB_PATH | ./marketplace.db | SQLite database path |
| env | SEED_SERVER | β | Domain to crawl on startup |
| flag | --addr | :8080 | Listen address |
| flag | --db | ./marketplace.db | Database path |
| flag | --seed | β | Seed server domain |
| flag | --crawl-interval | 6h | Re-crawl interval |
Stack
- Go (stdlib +
modernc.org/sqlite) - SQLite + FTS5 for full-text search
- Fly.io single machine, 256MB
- No JS framework β server-rendered HTML with keyboard navigation
Run locally
go build -o marketplace ./cmd/server/
./marketplace --seed kapoost.humanmcp.net
# open http://localhost:8080
Deploy
fly apps create humanmcp-marketplace
fly volumes create marketplace_data --size 1 --region ams
fly deploy
Key principles
- Listings only β marketplace indexes offers, trades, services
- No content hosting β index + link back, always
- Attribution β author server visible on every result
- Opt-in β register voluntarily
- Federated β anyone can run their own marketplace instance
- Open protocol β humanMCP REST API is the standard
Creative content (poems, essays, images) belongs on the author's server. A separate discovery service for that is planned.
License
MIT
