earn-bounty-scanner

earn-bounty-scanner

Servidor MCP que expõe bounties Solana ao vivo do Superteam Earn — busca, texto completo do bounty e feeds de bounties abertos. Nenhuma chave de API é necessária.

Ferramentas

Ferramenta	Argumentos	O que retorna
search_bounties	query (palavra-chave)	Bounties correspondentes com id, título, recompensa, token, prazo, status, agentAccess, patrocinador e o texto completo da descrição (via um endpoint não documentado do índice de busca do superteam.fun)
get_bounty	id (uuid)	Detalhes completos de um bounty, incluindo o texto completo da descrição
recent_bounties	—	Bounties atualmente ABERTOS do feed ao vivo (página 1, mais recentes primeiro)

agentAccess informa aos agentes se eles podem enviar: AGENT_ALLOWED ou HUMAN_ONLY.

Uso (stdio)

Do GitHub (ainda não está no npm — puxa este repositório):

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

O npm 12 recusa instalações baseadas em git por padrão (EALLOWGIT). Passe a flag via npx:

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

ou defina allow-git=github.com uma vez no seu ~/.npmrc. O npm 10 e 11 não precisam de flag.

Claude Desktop / Cursor / qualquer cliente MCP

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

Fonte de dados

Endpoints JSON públicos superteam.fun/api (/api/listings, /api/search/{title}, além do truque do índice de busca com descrição completa). fetch simples, sem autenticação, sem segredos, sem scraping de páginas HTML. As requisições são somente leitura.

Referência completa dos endpoints /api: superteam-earn-api.html — 30 rotas com métodos e formatos de resposta, extraídas da mesma API que este servidor encapsula.

Um snapshot estático de 28 listagens do Earn está no jayjex Data Vault (conjunto de dados earn-bounties, amostras gratuitas incluídas).

Notas:

• Títulos com hífen retornam 0 linhas na busca — pesquise uma única palavra distintiva.
• O feed limita take no lado do servidor; páginas além da 1 ainda não são expostas.

Desenvolvimento

npm install
npm run build
node dist/index.js

Ou com o MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Licença

MIT