Paybyrd Payment

v1.0.0Finance & Fintechstable

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.

claudemcpai-integration
Share:
44
Stars
0
Downloads
0
Weekly
0/5

What is Paybyrd Payment?

Paybyrd Payment is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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.

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.

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol server that enables Claude AI to in

Use Cases

Create payment links and process payments through Paybyrd API.
Handle refunds and retrieve order information.
paybyrd

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 15, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx claude

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Paybyrd Payment

The Paybyrd AI Agent Toolkit MCP server enables Claude and other AI agents to interact with Paybyrd's payment processing API through three focused tools: creating payment links for customers, processing refunds, and retrieving order information. Built in TypeScript and published under the @paybyrd scope on npm, it lets merchants and fintech developers embed real payment operations into AI-powered workflows without building custom API integrations.

Prerequisites

  • Node.js 18 or higher installed
  • A Paybyrd merchant account and a valid Paybyrd API key
  • npm or npx available to install and run the package
  • An MCP-compatible client such as Claude Desktop
1

Obtain a Paybyrd API key

Log in to your Paybyrd merchant dashboard and generate an API key under the developer or integrations section. Keep this key secret — it authorizes real payment operations.

2

Install the Paybyrd AI agent toolkit packages

Install the core toolkit and the Claude-specific package from npm.

npm install @paybyrd/ai-agent-toolkit @paybyrd/ai-agent-claude
3

Open your Claude Desktop configuration file

Edit claude_desktop_config.json. On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json.

4

Add the Paybyrd MCP server to your configuration

Register the server with your Paybyrd API key as an environment variable. The server reads this to authenticate every payment API call.

{
  "mcpServers": {
    "paybyrd": {
      "command": "npx",
      "args": ["-y", "@paybyrd/ai-agent-claude"],
      "env": {
        "PAYBYRD_API_KEY": "your_paybyrd_api_key_here"
      }
    }
  }
}
5

Restart Claude Desktop and test a payment operation

Restart the client and ask Claude to retrieve an existing order to verify connectivity. Avoid creating live payment links in testing without confirming you are pointed at the sandbox environment.

Paybyrd Payment Examples

Client configuration

claude_desktop_config.json entry for the Paybyrd payment MCP server using the @paybyrd/ai-agent-claude package.

{
  "mcpServers": {
    "paybyrd": {
      "command": "npx",
      "args": ["-y", "@paybyrd/ai-agent-claude"],
      "env": {
        "PAYBYRD_API_KEY": "your_paybyrd_api_key_here"
      }
    }
  }
}

Prompts to try

Example prompts for the three payment tools: create payment link, create refund, and retrieve order.

- "Create a payment link for €49.99 for order #ORD-2024-001 and send it to the customer"
- "Process a full refund for order ID abc123"
- "Retrieve the details and current status of order xyz789"
- "Create a payment link for $199 with a description of 'Annual subscription renewal'"
- "Check whether order #ORD-2024-055 has been paid or is still pending"

Troubleshooting Paybyrd Payment

Authentication errors when creating payment links

Confirm that PAYBYRD_API_KEY in your MCP config matches the key from your Paybyrd dashboard exactly, with no leading or trailing whitespace. Sandbox and production keys are different — ensure you are using the correct environment's key.

npx cannot find @paybyrd/ai-agent-claude

Run `npm install -g @paybyrd/ai-agent-toolkit @paybyrd/ai-agent-claude` to install globally, then use `ai-agent-claude` as the command in your MCP config. Also verify your npm registry is accessible and not blocked by a firewall.

Refund fails with an order-not-found error

Ensure the order ID you provide matches the exact format used by Paybyrd (check your dashboard for the correct ID format). Refunds can only be processed on completed, paid orders — verify the order status via the retrieve order tool first.

Frequently Asked Questions about Paybyrd Payment

What is Paybyrd Payment?

Paybyrd Payment is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Paybyrd Payment?

Follow the installation instructions on the Paybyrd Payment GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Paybyrd Payment?

Paybyrd Payment works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Paybyrd Payment free to use?

Yes, Paybyrd Payment is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Paybyrd Payment?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides