humanMCP Marketplace

humanMCP Marketplace

Um quadro de anúncios federado entre servidores humanMCP pessoais. Sem contas. Sem algoritmos. Apenas humanos e suas ofertas.

Ao vivo: https://marketplace.humanmcp.net Endpoint MCP: POST https://marketplace.humanmcp.net/mcp

O que faz

Cada humano pode executar seu próprio servidor humanMCP — publicando anúncios, ofertas e trocas. O marketplace rastreia esses servidores e constrói um único índice pesquisável de anúncios.

Pense nisso como uma praça da cidade onde cada barraca é de propriedade independente. O marketplace não hospeda conteúdo — ele indexa e faz link de volta para a origem.

Conecte um agente

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

Ferramentas MCP

Ferramenta	Descrição
search_marketplace	Buscar anúncios em todos os servidores — ofertas, trocas, serviços
list_servers	Todas as instâncias humanMCP registradas
get_server	Detalhes do servidor

API REST

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

Descoberta de agentes

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

Interface Web

GET  /                  → homepage — listings + servers
GET  /q?q={query}       → search results
GET  /s/{domain}        → server page

Atalhos de teclado: / pesquisar, j/k navegar, Enter abrir, d tema, ? ajuda.

Registre seu servidor

Qualquer instância humanMCP pode participar. Sem necessidade de conta — apenas seu domínio:

curl -X POST https://marketplace.humanmcp.net/register \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourname-humanmcp.fly.dev"}'

O marketplace irá:

1. Verificar se é um humanMCP real (busca /.well-known/agent.json)
2. Indexar todos os anúncios de /listings/feed.json
3. Adicionar ao cronograma de rastreamento (a cada 6 horas)

Requisitos: seu servidor deve expor /.well-known/agent.json e /listings/feed.json.

Como funciona o rastreamento

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

Os anúncios permanecem no seu servidor. O marketplace mantém apenas um índice de busca.

Configuração

Origem	Nome	Padrão	Descrição
env	PORT	8080	Porta de escuta
env	DB_PATH	./marketplace.db	Caminho do banco de dados SQLite
env	SEED_SERVER	—	Domínio para rastrear na inicialização
flag	--addr	:8080	Endereço de escuta
flag	--db	./marketplace.db	Caminho do banco de dados
flag	--seed	—	Domínio do servidor inicial
flag	--crawl-interval	6h	Intervalo de re-rastreamento

Stack

• Go (stdlib + modernc.org/sqlite)
• SQLite + FTS5 para busca em texto completo
• Fly.io single machine, 256MB
• Sem framework JS — HTML renderizado no servidor com navegação por teclado

Execute localmente

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

Princípios-chave

1. Somente anúncios — o marketplace indexa ofertas, trocas e serviços
2. Sem hospedagem de conteúdo — índice + link de volta, sempre
3. Atribuição — servidor do autor visível em cada resultado
4. Adesão voluntária — registre-se voluntariamente
5. Federado — qualquer pessoa pode executar sua própria instância do marketplace
6. Protocolo aberto — a API REST humanMCP é o padrão

Conteúdo criativo (poemas, ensaios, imagens) pertence ao servidor do autor. Um serviço de descoberta separado para isso está planejado.

Licença

MIT