humanMCP Marketplace

humanMCP Marketplace

Un tablón de anuncios federado entre servidores humanMCP personales. Sin cuentas. Sin algoritmos. Solo humanos y sus ofertas.

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

Qué hace

Cada humano puede ejecutar su propio servidor humanMCP — publicando anuncios, ofertas y trueques. El marketplace rastrea estos servidores y construye un índice único y buscable de anuncios.

Piénsalo como una plaza del pueblo donde cada puesto es de propiedad independiente. El marketplace no aloja contenido — indexa y enlaza de vuelta al origen.

Conectar un agente

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

Herramientas MCP

Herramienta	Descripción
search_marketplace	Buscar anuncios en todos los servidores — ofertas, trueques, servicios
list_servers	Todas las instancias humanMCP registradas
get_server	Detalle del 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

Descubrimiento de agentes

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

Interfaz web

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

Atajos de teclado: / buscar, j/k navegar, Enter abrir, d tema, ? ayuda.

Registra tu servidor

Cualquier instancia humanMCP puede unirse. No se necesita cuenta — solo tu dominio:

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

El marketplace hará:

1. Verificar que es un humanMCP real (obtiene /.well-known/agent.json)
2. Indexar todos los anuncios de /listings/feed.json
3. Añadir al programa de rastreo (cada 6 horas)

Requisitos: tu servidor debe exponer /.well-known/agent.json y /listings/feed.json.

Cómo funciona el rastreo

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

Los anuncios permanecen en tu servidor. El marketplace solo mantiene un índice de búsqueda.

Configuración

Fuente	Nombre	Predeterminado	Descripción
env	PORT	8080	Puerto de escucha
env	DB_PATH	./marketplace.db	Ruta de la base de datos SQLite
env	SEED_SERVER	—	Dominio a rastrear al inicio
flag	--addr	:8080	Dirección de escucha
flag	--db	./marketplace.db	Ruta de la base de datos
flag	--seed	—	Dominio del servidor semilla
flag	--crawl-interval	6h	Intervalo de re-rastreo

Stack

• Go (stdlib + modernc.org/sqlite)
• SQLite + FTS5 para búsqueda de texto completo
• Fly.io máquina única, 256MB
• Sin framework JS — HTML renderizado en servidor con navegación por teclado

Ejecutar localmente

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

Desplegar

fly apps create humanmcp-marketplace
fly volumes create marketplace_data --size 1 --region ams
fly deploy

Principios clave

1. Solo anuncios — el marketplace indexa ofertas, trueques, servicios
2. Sin alojamiento de contenido — índice + enlace de vuelta, siempre
3. Atribución — el servidor del autor visible en cada resultado
4. Opt-in — regístrate voluntariamente
5. Federado — cualquiera puede ejecutar su propia instancia del marketplace
6. Protocolo abierto — la API REST de humanMCP es el estándar

El contenido creativo (poemas, ensayos, imágenes) pertenece al servidor del autor. Se planea un servicio de descubrimiento separado para eso.

Licencia

MIT