Payman AI MCP Server

by hrishi0102

Payman API MCP-Server

Ein MCP-Server (Model Context Protocol), der eine nahtlose Integration mit den Zahlungs-APIs von Payman AI bietet und es KI-Assistenten ermöglicht, Zahlungsempfänger zu erstellen, nach vorhandenen Zahlungsempfängern zu suchen, Zahlungen zu senden und Kontostände in natürlicher Sprache zu überprüfen.

Überblick

Dieser MCP-Server stellt die Zahlungsfunktionalität von Payman AI als Tools bereit, die von LLM-Anwendungen wie Claude genutzt werden können. Er ermöglicht KI-Assistenten die Durchführung folgender Operationen:

  • API-Schlüssel zur Authentifizierung festlegen
  • Erstellen Sie verschiedene Arten von Zahlungsempfängern (TEST_RAILS, US_ACH, CRYPTO_ADDRESS)
  • Senden Sie Zahlungen an registrierte Zahlungsempfänger
  • Suche nach Zahlungsempfängern anhand verschiedener Kriterien
  • Kontostände prüfen

Diese Implementierung folgt dem Model Context Protocol (MCP)-Standard und gewährleistet die Kompatibilität mit jedem MCP-kompatiblen Client.

Merkmale

  • Sichere API-Authentifizierung : Verwalten Sie API-Schlüssel sicher innerhalb der Sitzung
  • Mehrere Zahlungsempfängertypen :
    • TEST_RAILS Zahlungsempfänger zum Testen
    • US_ACH-Zahlungsempfänger für US-Banküberweisungen
    • CRYPTO_ADDRESS-Zahlungsempfänger für Kryptowährungstransaktionen
  • Zahlungsvorgänge :
    • Senden Sie Zahlungen mit benutzerdefinierten Beträgen und Memos
    • Aktuelle Guthaben abrufen
  • Suchfunktionen :
    • Suchen Sie nach Zahlungsempfängern nach Namen, Kontaktinformationen, Kontodetails usw.
  • Fehlerbehandlung : Umfassende Fehlerbehandlung für alle API-Operationen
  • Sichere Transporte : Unterstützt sowohl Standard- als auch SSE-Transporte (Server-Sent Events)

Voraussetzungen

Installation

Installation über Smithery

So installieren Sie payman_mcp für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @hrishi0102/payman_mcp --client claude
  1. Klonen Sie das Repository:
    git clone https://github.com/yourusername/payman-mcp-server.git cd payman-mcp-server
  2. Installieren Sie Abhängigkeiten:
    npm install # OR yarn install
  3. Erstellen Sie den TypeScript-Code:
    npm run build # OR yarn build

Konfiguration

Der Server benötigt keine Konfigurationsdateien. API-Schlüssel werden zur Laufzeit mit dem Tool set-api-key festgelegt.

Ausführen des Servers

Standard-E/A-Modus (für Claude Desktop usw.)

Führen Sie den Server im Standardmodus aus, der mit Claude Desktop und ähnlichen MCP-Clients kompatibel ist:

Überprüfen Sie, ob der Server richtig eingerichtet ist:

node /ABSOLUTE/PATH/TO/PARENT/FOLDER/payman-mcp/build/payman-server.js

Wenn alles in Ordnung ist, können Sie jetzt den Payman MCP-Server zu jedem Client hinzufügen.

  • Für Claude Desktop: Hier
  • Für Cursor: Hier

Server-Sent Events (SSE)-Modus (für Webintegration)

So führen Sie den Server mit SSE-Transport aus (erfordert zusätzliche Abhängigkeiten: express und cors ):

node build/payman-server-sse.js

Dadurch wird ein Webserver auf Port 3001 mit den folgenden Endpunkten gestartet:

  • /sse – Der SSE-Endpunkt für die Server-zu-Client-Kommunikation
  • /messages - Der Endpunkt für Client-zu-Server-Nachrichten

Integration mit MCP-Clients

Claude Desktop

  1. Öffnen Sie Ihre Claude Desktop-Konfigurationsdatei:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Fügen Sie die Serverkonfiguration hinzu:
    { "mcpServers": { "payman": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/payman-mcp-server/build/payman-server.js"] } } }
  3. Starten Sie Claude Desktop neu

Andere MCP-Clients

Informationen zum Hinzufügen von MCP-Servern finden Sie bei anderen MCP-Clients wie Cursor in der jeweiligen Dokumentation.

Benutzerhandbuch

Sobald der Server mit einem MCP-Client verbunden ist, können Sie die folgenden Tools verwenden:

Festlegen des API-Schlüssels

Zuerst müssen Sie Ihren Payman-API-Schlüssel festlegen:

Please use the set-api-key tool with my Payman API key: YOUR_API_KEY_HERE

Zahlungsempfänger erstellen

Testen Sie Rails Payee
Create a test payee named "Test User" with the tag "test"
US-ACH-Zahlungsempfänger
Create a US ACH payee with these details: - Name: John Doe - Account Type: checking - Account Number: 12345678 - Routing Number: 123456789 - Account Holder Name: John Doe - Account Holder Type: individual
Krypto-Zahlungsempfänger
Create a crypto payee with: - Name: Crypto Wallet - Address: 0x1234567890abcdef - Chain: ethereum - Currency: ETH

Zahlungen senden

Send a payment of 100 to payee ID "pay_123abc" with the memo "Monthly service"

Suche nach Zahlungsempfängern

Search for all payees with the name "John"

Kontostand prüfen

What's my current balance?

Werkzeugreferenz

set-api-key

Legt den Payman-API-Schlüssel für die Authentifizierung fest.

  • Parameter :
    • apiKey (Zeichenfolge): Der Payman-API-Schlüssel

create-test-rails-payee

Erstellt einen TEST_RAILS-Zahlungsempfänger zum Testen.

  • Parameter :
    • name (Zeichenfolge): Name des Zahlungsempfängers
    • type (Zeichenfolge): "TEST_RAILS" (Standard)
    • tags (string[]): Optionale Tags für den Zahlungsempfänger

create-us-ach-payee

Erstellt einen US_ACH-Zahlungsempfänger für Banküberweisungen.

  • Parameter :
    • type (Zeichenfolge): "US_ACH" (Standard)
    • accountType (enum): „Girokonto“ oder „Sparkonto“
    • accountNumber (Zeichenfolge): Die Bankkontonummer
    • routingNumber (Zeichenfolge): Die Routingnummer
    • accountHolderName (Zeichenfolge): Der Name des Kontoinhabers
    • accountHolderType (enum): „Einzelperson“ oder „Unternehmen“
    • name (Zeichenfolge): Name für diesen Zahlungsempfänger
    • Plus zusätzliche optionale Parameter (Tags, Kontaktdaten)

create-crypto-payee

Erstellt einen CRYPTO_ADDRESS-Zahlungsempfänger für Kryptowährungszahlungen.

  • Parameter :
    • type (Zeichenfolge): "CRYPTO_ADDRESS" (Standard)
    • address (Zeichenfolge): Die Kryptowährungsadresse
    • chain (Zeichenfolge): Die zu verwendende Blockchain
    • currency (Zeichenfolge): Die Kryptowährung/das Token
    • name (Zeichenfolge): Name für diesen Zahlungsempfänger
    • Plus zusätzliche optionale Parameter (Tags, Kontaktdaten)

send-payment

Sendet eine Zahlung an einen Zahlungsempfänger.

  • Parameter :
    • payeeId (Zeichenfolge): ID des zu zahlenden Zahlungsempfängers
    • amountDecimal (Zahl): Zu sendender Betrag
    • walletId (Zeichenfolge, optional): Zu verwendende spezifische Brieftasche
    • memo (Zeichenfolge, optional): Zahlungsmemo
    • metadata (Objekt, optional): Zusätzliche Metadaten

search-payees

Suche nach Zahlungsempfängern anhand verschiedener Kriterien.

  • Parameter : Mehrere optionale Suchparameter
    • name , contactEmail , accountNumber usw.

get-balance

Ruft den aktuellen Kontostand ab.

  • Parameter : Keine

Fehlerbehandlung

Alle Tools verfügen über eine ordnungsgemäße Fehlerbehandlung und geben in folgenden Fällen aussagekräftige Fehlermeldungen zurück:

  • Der API-Schlüssel wurde nicht festgelegt
  • API-Anfragen schlagen fehl
  • Es wurden ungültige Parameter angegeben
  • Es treten Netzwerkprobleme auf

Sicherheitsüberlegungen

  • API-Schlüssel werden für die Dauer der Sitzung im Speicher gespeichert
  • Der Server speichert keine Anmeldeinformationen auf der Festplatte
  • Alle Anfragen an die Payman-API verwenden die richtigen Autorisierungsheader
  • Model Context Protocol für die MCP-Spezifikation
  • Payman AI für die Zahlungs-API
  • Zod zur Eingabevalidierung

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Ein Server, der einfachen Zugriff auf die APIs von Payman AI bietet und es Benutzern ermöglicht, Zahlungsempfänger zu erstellen, nach Zahlungsempfängern zu suchen, Zahlungen zu senden und Kontostände mithilfe von Eingabeaufforderungen in natürlicher Sprache zu überprüfen.

  1. Überblick
    1. Merkmale
      1. Voraussetzungen
        1. Installation
          1. Installation über Smithery
        2. Konfiguration
          1. Ausführen des Servers
            1. Standard-E/A-Modus (für Claude Desktop usw.)
            2. Server-Sent Events (SSE)-Modus (für Webintegration)
          2. Integration mit MCP-Clients
            1. Claude Desktop
            2. Andere MCP-Clients
          3. Benutzerhandbuch
            1. Festlegen des API-Schlüssels
            2. Zahlungsempfänger erstellen
            3. Zahlungen senden
            4. Suche nach Zahlungsempfängern
            5. Kontostand prüfen
          4. Werkzeugreferenz
            1. set-api-key
            2. create-test-rails-payee
            3. create-us-ach-payee
            4. create-crypto-payee
            5. send-payment
            6. search-payees
            7. get-balance
          5. Fehlerbehandlung
            1. Sicherheitsüberlegungen

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                An unofficial server that allows AI assistants to access Fathom Analytics data, enabling users to retrieve account information, site statistics, events, aggregated reports, and real-time visitor tracking.
                Last updated -
                5
                8
                1
                TypeScript
                MIT License
              • A
                security
                F
                license
                A
                quality
                An MCP server that integrates with Fewsats allowing AI agents to securely purchase anything by retrieving balances, accessing payment methods, and processing payments.
                Last updated -
                4
                11
                Python
              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables Claude AI to interact with Paybyrd's payment processing API, allowing for creating payment links, processing refunds, and retrieving order information.
                Last updated -
                5
                TypeScript
              • -
                security
                F
                license
                -
                quality
                Provides AI assistants like Claude or Cursor with access to Payman AI's documentation, helping developers build integrations more efficiently.
                Last updated -
                TypeScript
                • Linux
                • Apple

              View all related MCP servers

              ID: 76v04dmvlh