earn-bounty-scanner

earn-bounty-scanner

Servidor MCP que expone recompensas de Solana en vivo de Superteam Earn — búsqueda, texto completo de recompensas y fuentes de recompensas abiertas. No se requiere clave API.

Herramientas

Herramienta	Argumentos	Qué devuelve
search_bounties	query (palabra clave)	Recompensas coincidentes con id, título, recompensa, token, fecha límite, estado, agentAccess, patrocinador y el texto completo de la descripción (a través de un endpoint no documentado del índice de búsqueda de superteam.fun)
get_bounty	id (uuid)	Detalles completos de una recompensa, incluido el texto completo de la descripción
recent_bounties	—	Recompensas actualmente ABIERTAS de la fuente en vivo (página 1, más recientes primero)

agentAccess indica a los agentes si pueden enviar: AGENT_ALLOWED o HUMAN_ONLY.

Uso (stdio)

Desde GitHub (aún no en npm — extrae este repositorio):

npx -y github:jayjex/earn-bounty-scanner

npm 12 rechaza instalaciones basadas en git por defecto (EALLOWGIT). Pasa la bandera a través de npx:

npx --allow-git=all -y github:jayjex/earn-bounty-scanner

o establece allow-git=github.com una vez en tu ~/.npmrc. npm 10 y 11 no necesitan bandera.

Claude Desktop / Cursor / cualquier cliente MCP

{
  "mcpServers": {
    "earn-bounty-scanner": {
      "command": "npx",
      "args": ["--allow-git=all", "-y", "github:jayjex/earn-bounty-scanner"]
    }
  }
}

Fuente de datos

Endpoints JSON públicos superteam.fun/api (/api/listings, /api/search/{title}, más el truco del índice de búsqueda para descripciones completas). fetch simple, sin autenticación, sin secretos, sin scraping de páginas HTML. Las solicitudes son de solo lectura.

Referencia completa de endpoints /api: superteam-earn-api.html — 30 rutas con métodos y formas de respuesta, extraídas de la misma API que envuelve este servidor.

Una instantánea estática de 28 listados de Earn vive en el jayjex Data Vault (conjunto de datos earn-bounties, muestras gratuitas incluidas).

Notas:

• Los títulos con guiones devuelven 0 filas de búsqueda — busca una sola palabra distintiva en su lugar.
• La fuente limita take en el lado del servidor; las páginas más allá de 1 aún no están expuestas.

Desarrollo

npm install
npm run build
node dist/index.js

O con el MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Licencia

MIT