Back to Browse

Humanmcp Marketplace MCP Server

by Kapoost
Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Federated listings from personal humanMCP servers. Search offers, trades by humans.

About

Federated listings from personal humanMCP servers. Search offers, trades by humans.

Remote endpoints: streamable-http: https://marketplace.humanmcp.net/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

3 tools verified · Open access · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-kapoost-humanmcp-marketplace": {
      "url": "https://marketplace.humanmcp.net/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

humanMCP Marketplace

smithery badge

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

ToolDescription
search_marketplaceSearch listings across all servers — offers, trades, services
list_serversAll registered humanMCP instances
get_serverServer 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:

  1. Verify it's a real humanMCP (fetches /.well-known/agent.json)
  2. Index all listings from /listings/feed.json
  3. 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

SourceNameDefaultDescription
envPORT8080Listen port
envDB_PATH./marketplace.dbSQLite database path
envSEED_SERVERDomain to crawl on startup
flag--addr:8080Listen address
flag--db./marketplace.dbDatabase path
flag--seedSeed server domain
flag--crawl-interval6hRe-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

  1. Listings only — marketplace indexes offers, trades, services
  2. No content hosting — index + link back, always
  3. Attribution — author server visible on every result
  4. Opt-in — register voluntarily
  5. Federated — anyone can run their own marketplace instance
  6. 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

Reviews

No reviews yet

Be the first to review this server!