humanMCP Marketplace — federated listings across personal MCP servers

io.github.kapoostPublished by GitHub account kapoostv1.0.0Updated Oct 24, 2026

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

The publisher's own server: MCP Marketplace

VerifiedStreamable HTTPWeb executableProductivity & WorkflowWeb Search & Scraping

Overview

AI-generated overview

Lets an assistant search a federated index of listings, offers and trades published by independent humanMCP servers.

What you can do
The marketplace crawls personal humanMCP servers and builds one searchable index of their listings, offers and trades (R9). It exposes tools to search listings across all servers, list registered instances and fetch server detail (R15-R17), plus a REST API for servers, search, feeds and registration (R18). It indexes and links back to the origin rather than hosting content (R11, R48).
When to use it
Use it when an assistant needs to find human-published offers, trades or services spread across many independent servers, or to discover which humanMCP instances exist. It is a discovery and search layer, not a place to publish or store content (R47, R53).
Requirements
Remote streamable HTTP endpoint at no accounts, API keys, environment variables or headers are declared. Running your own instance instead needs Go and SQLite, with optional settings such as PORT, DB_PATH, SEED_SERVER and --crawl-interval (R34-R40).
Before you install
The marketplace crawls third-party servers and indexes their listings, so listing data leaves the origin server and is stored in the marketplace index (R29, R31). Registering a server is a write action that submits a domain for crawling (R23). No accounts or credentials are requested, and no payments are involved.

Installation

In SourceWeft

  1. Open humanMCP Marketplace — federated listings across personal MCP servers in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.kapoost%2Fhumanmcp-marketplace/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "humanmcp-marketplace-federated-listings": {
      "type": "http",
      "url": "https://marketplace.humanmcp.net/mcp"
    }
  }
}

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

json
{  "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 serversGET  /servers/{domain}     → server detailGET  /search?q={query}     → full-text search across all listingsGET  /search?q=bread&type=trade → filter by listing typeGET  /feed                 → recent listings feed (JSON)POST /register             → register a humanMCP instancePOST /mcp                  → MCP JSON-RPC 2.0 endpoint

Agent discovery

GET  /.well-known/agent.json  → agent profile cardGET  /openapi.json            → OpenAPI 3.1 specGET  /healthz                 → status + server/listing counts

Web UI

GET  /                  → homepage — listings + serversGET  /q?q={query}       → search resultsGET  /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:

bash
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_SERVER—Domain to crawl on startup
flag--addr:8080Listen address
flag--db./marketplace.dbDatabase path
flag--seed—Seed 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

bash
go build -o marketplace ./cmd/server/./marketplace --seed kapoost.humanmcp.net# open http://localhost:8080

Deploy

bash
fly apps create humanmcp-marketplacefly volumes create marketplace_data --size 1 --region amsfly 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

Source: README.md at commit dcddd97

Tools

3

search_marketplace

Search marketplace

Search across all humanMCP servers for listings, offers, and trades.

Parameterstypequeryrequiredserver

list_servers

List servers

List all registered humanMCP instances in the marketplace.

Takes no parameters.

get_server

Get server details

Get details about a specific humanMCP server and its content.

Parametersdomainrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Mcp-Marketplace integrations