Labsco
hrishi0102 logo

Payman API

★ 3

from hrishi0102

Integrates with Payman AI's payment APIs to manage payees, payments, and balances using natural language.

🔥🔥🔥✓ VerifiedFreeAdvanced setup
#automation#payments#git#finance#security

Payman API MCP Server

smithery badge

An MCP (Model Context Protocol) server that provides seamless integration with Payman AI's payment APIs, allowing AI assistants to create payees, search for existing payees, send payments, and check balances through natural language.

Overview

This MCP server exposes Payman AI's payment functionality as tools that can be used by LLM applications such as Claude. It enables AI assistants to perform the following operations:

  • Set API keys for authentication
  • Create different types of payees (TEST_RAILS, US_ACH, CRYPTO_ADDRESS)
  • Send payments to registered payees
  • Search for payees based on various criteria
  • Check account balances

This implementation follows the Model Context Protocol (MCP) standard, ensuring compatibility with any MCP-compatible client.

Features

  • Secure API Authentication: Manage API keys securely within the session
  • Multiple Payee Types:
    • TEST_RAILS payees for testing
    • US_ACH payees for US bank transfers
    • CRYPTO_ADDRESS payees for cryptocurrency transactions
  • Payment Operations:
    • Send payments with custom amounts and memos
    • Retrieve current balances
  • Search Capabilities:
    • Search payees by name, contact information, account details, etc.
  • Error Handling: Comprehensive error handling for all API operations
  • Secure Transports: Supports both stdio and SSE (Server-Sent Events) transports

Integrating with MCP Clients

Claude Desktop

  1. Open your Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the server configuration:

    Copy & paste — that's it
    {
  "mcpServers": {
    "payman": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/payman-mcp-server/build/payman-server.js"]
    }
  }
}

  3. Restart Claude Desktop

Other MCP Clients

For other MCP clients like Cursor, refer to their specific documentation for adding MCP servers.

Tool Reference

set-api-key

Sets the Payman API key for authentication.

  • Parameters:
    • apiKey (string): The Payman API key

create-test-rails-payee

Creates a TEST_RAILS payee for testing.

  • Parameters:
    • name (string): Name of the payee
    • type (string): "TEST_RAILS" (default)
    • tags (string[]): Optional tags for the payee

create-us-ach-payee

Creates a US_ACH payee for bank transfers.

  • Parameters:
    • type (string): "US_ACH" (default)
    • accountType (enum): "checking" or "savings"
    • accountNumber (string): The bank account number
    • routingNumber (string): The routing number
    • accountHolderName (string): The name of the account holder
    • accountHolderType (enum): "individual" or "business"
    • name (string): Name for this payee
    • Plus additional optional parameters (tags, contactDetails)

create-crypto-payee

Creates a CRYPTO_ADDRESS payee for cryptocurrency payments.

  • Parameters:
    • type (string): "CRYPTO_ADDRESS" (default)
    • address (string): The cryptocurrency address
    • chain (string): The blockchain to use
    • currency (string): The cryptocurrency/token
    • name (string): Name for this payee
    • Plus additional optional parameters (tags, contactDetails)

send-payment

Sends a payment to a payee.

  • Parameters:
    • payeeId (string): ID of the payee to pay
    • amountDecimal (number): Amount to send
    • walletId (string, optional): Specific wallet to use
    • memo (string, optional): Payment memo
    • metadata (object, optional): Additional metadata

search-payees

Search for payees based on various criteria.

  • Parameters: Multiple optional search parameters
    • name, contactEmail, accountNumber, etc.

get-balance

Retrieves the current account balance.

  • Parameters: None

Error Handling

All tools include proper error handling and will return descriptive error messages if:

  • The API key has not been set
  • API requests fail
  • Invalid parameters are provided
  • Network issues occur

Security Considerations

  • API keys are stored in memory for the duration of the session

  • The server does not persist any credentials to disk

  • All requests to the Payman API use proper authorization headers

  • Model Context Protocol for the MCP specification

  • Payman AI for the payment API

  • Zod for input validation