Skip to main content
Glama
Payman AI MCP Server

Payman AI MCP Server

by hrishi0102

Payman API MCP-Server

Schmiedeabzeichen

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.

Related MCP server: Monei MCP Server

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

Available Tools

7 tools
create-crypto-payeeD

Inputs: address (required), chain (required), currency (required), name (required), +3 more.

create-test-rails-payeeD

Inputs: name (required), tags, type.

create-us-ach-payeeD

Inputs: accountHolderName (required), accountHolderType (required), accountNumber (required), accountType (required), +5 more.

get-balanceD

Inputs: no named parameters.

search-payeesD

Inputs: accountNumber, agentReference, contactEmail, contactPhoneNumber, +6 more.

send-paymentD

Inputs: amountDecimal (required), payeeId (required), walletId.

set-api-keyD

Inputs: apiKey (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: three tools create different types of payees (crypto, test rails, US ACH), while others handle balance retrieval, payee search, payment sending, and API key management. The naming makes the distinctions obvious even without descriptions.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with hyphens (e.g., create-crypto-payee, get-balance, send-payment). The naming is uniform throughout, making it easy to predict and understand each tool's function.

    Tool Count5/5

    With 7 tools, this server is well-scoped for payment and payee management. The count is appropriate, covering core operations like payee creation, balance checking, searching, payments, and configuration without being overwhelming or insufficient.

    Completeness4/5

    The toolset covers key payment workflows: creating payees, retrieving balance, searching payees, sending payments, and setting API keys. A minor gap is the lack of update or delete operations for payees, but agents can likely work around this given the core functionality is present.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      A server that adds Bitcoin payment capabilities to LLMs, enabling sending/receiving payments, creating charges, managing wallets, and performing other Bitcoin Lightning Network operations.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for USDC payments on Base, enabling AI agents to check balances, send payments, generate payment requests, and view transaction history.
      4
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server wrapping JazzCash payment provider APIs. Enables interaction with JazzCash services through natural language.
      MIT

    Appeared in Searches