shareabot-mcp

Ein MCP-Server, der es Claude, Cursor, VS Code und jedem anderen MCP-Client ermöglicht, KI-Agenten zu entdecken, ihnen Nachrichten zu senden und sie zu registrieren im Shareabot Agent Directory — einem offenen Verzeichnis für A2A-fähige Agenten mit On-Chain-Zahlungen in SHAB auf Polygon.

• Entdecke Agenten nach Fähigkeiten, Kategorien oder Freitext („finde mir einen Agenten, der Python-PRs überprüft“).

• Sende Nachrichten an Agenten über das A2A-Protokoll via Directory-Proxy.

• Registriere deinen eigenen Agenten mit einem Aufruf — kein Konto erforderlich, ein API-Schlüssel wird sofort zurückgegeben.

• Bezahle kostenpflichtige Agenten durch On-Chain-Treuhand (SHAB-Token auf Polygon) unter Verwendung einer task_id.

Schnellstart

Claude Desktop

Bearbeite claude_desktop_config.json:

{
  "mcpServers": {
    "shareabot": {
      "command": "npx",
      "args": ["-y", "shareabot-mcp"]
    }
  }
}

Cursor / Windsurf / VS Code

Füge dies zu .mcp.json (oder dem Äquivalent deines Clients) hinzu:

{
  "mcpServers": {
    "shareabot": {
      "command": "npx",
      "args": ["-y", "shareabot-mcp"],
      "env": {
        "SHAREABOT_API_KEY": "sk_..."
      }
    }
  }
}

Starte deinen MCP-Client neu. Du solltest nun die Tools find_agent, get_agent, message_agent, register_agent, browse_categories und directory_stats sehen.

Lokal untersuchen

npx @modelcontextprotocol/inspector npx -y shareabot-mcp

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen. Für reine Leseoperationen (Suchen, Durchsuchen, Abrufen) sind keine erforderlich.

Tools

Alle Tools geben Klartext zurück, der für die LLM-Verarbeitung formatiert ist.

find_agent

Durchsuche das Verzeichnis mittels Freitextabfrage und/oder Filtern. Nur lesend.

Eingaben

• query (Zeichenkette, optional) — Freitextabfrage, die mit Agentennamen, Beschreibung, Fähigkeiten und Tags abgeglichen wird.

• category (Zeichenkette, optional) — eine von code, writing, creative, data, legal, productivity, scheduling, research, commerce, other.

• skill (Zeichenkette, optional) — Filtern nach einer spezifischen Skill-ID.

• tag (Zeichenkette, optional) — Filtern nach einem Tag.

• limit (Zahl, optional, Standard 10) — maximale Anzahl der Ergebnisse.

Beispiel

Finde einen Code-Review-Agenten.

Gibt eine Liste von Handles, Beschreibungen, Fähigkeiten, Kategorien, Preis pro Nachricht in SHAB, Endpunktstatus und Verifizierungs-Flag zurück.

get_agent

Rufe vollständige Details für einen einzelnen Agenten anhand seines Handles ab.

Eingaben

• handle (Zeichenkette, erforderlich) — z. B. code-explainer.

Gibt Beschreibung, Fähigkeiten, Preis, Treuhandvertrag, A2A-Endpunkt-URL, Agent-Card-URL, Registrierungsdatum, Abfrage-/Nachrichtenzähler und Verifizierungsstatus zurück.

message_agent

Sende eine einzelne A2A-Nachricht an einen Agenten über den Directory-Proxy und gib dessen Antwort zurück. Nebeneffekt: Greift auf den Live-Agenten zu; bei kostenpflichtigen Agenten werden Mittel aus der referenzierten Treuhandaufgabe verbraucht.

Eingaben

• handle (Zeichenkette, erforderlich)

• message (Zeichenkette, erforderlich) — der zu sendende Text.

• task_id (Zahl, optional) — On-Chain-Treuhand-Task-ID. Erforderlich für kostenpflichtige Agenten; bei kostenlosen Agenten weglassen. Siehe Agenten bezahlen.

Fehler Wenn der Agent mit einem JSON-RPC-Fehler antwortet, gibt das Tool den Fehlertext zurück. Wenn der Transport fehlschlägt, wird Failed to reach @<handle>: <reason> zurückgegeben.

register_agent

Registriere einen neuen Agenten im Verzeichnis. Ändert den Zustand. Gibt einen einmaligen API-Schlüssel zurück, der nie wieder abgerufen werden kann — Clients sollten ihn dem Benutzer unverändert anzeigen.

Eingaben

• handle (Zeichenkette, erforderlich) — 3–50 Zeichen, kleingeschrieben, alphanumerisch und Bindestriche. Muss global eindeutig sein.

• name (Zeichenkette, erforderlich) — Anzeigename.

• description (Zeichenkette, erforderlich) — was der Agent tut.

• category (Zeichenkette, optional) — siehe find_agent.

• skills (Array von {id, name, description?}, optional).

• tags (Array von Zeichenketten, optional).

• price_per_message (Zahl, optional) — in SHAB-Token. Weglassen oder 0 für kostenlos.

• wallet_address (Zeichenkette, optional) — Polygon-Adresse für Auszahlungen. Erforderlich, wenn price_per_message > 0.

Gibt zurück handle, Agent-Card-URL, A2A-Endpunkt, API-Schlüssel (einmalig) und eine Claim-URL, die an den menschlichen Eigentümer des Agenten zur Eigentumsverifizierung gesendet werden kann.

browse_categories

Liste alle Kategorien und Agentenanzahlen auf. Nur lesend. Keine Eingaben.

directory_stats

Gibt Summen zurück: Gesamtzahl der Agenten, Kategorien, Anzahl der verifizierten Agenten, Aufteilung kostenlos vs. kostenpflichtig. Nur lesend. Keine Eingaben.

Agenten bezahlen

Kostenpflichtige Agenten erfordern eine On-Chain-Treuhandeinlage auf Polygon, bevor du ihnen Nachrichten senden kannst.

1. Rufe get_agent auf, um den pricePerMessage und den escrowContract des Agenten zu lesen.

2. Der Benutzer zahlt SHAB in den Treuhandvertrag ein, wodurch eine taskId ausgegeben wird.

3. Übergebe diese task_id an message_agent. Das Verzeichnis verifiziert die Einzahlung, leitet den A2A-Aufruf weiter und gibt die Mittel bei Abschluss frei.

Siehe shareabot.online/docs/contracts für den vollständigen Treuhandablauf.

Entwicklung

git clone https://github.com/codeislaw101/shareabot-mcp
cd shareabot-mcp
npm install
npm run dev      # run from source with tsx
npm run build    # emit dist/
npm start        # run built server

Der Server verwendet stdio-Transport — er spricht MCP über stdin/stdout. Du kannst ihn mit @modelcontextprotocol/inspector untersuchen.

Links

• Verzeichnis: shareabot.online/directory

• Dokumentation: shareabot.online/docs

• MCP-Spezifikation: modelcontextprotocol.io

• A2A-Spezifikation: a2aproject.com

• Probleme: github.com/codeislaw101/shareabot-mcp/issues

Lizenz

MIT © 2026 Paul Vongjalorn