Paybyrd AI Agent Toolkit

A toolkit for integrating Paybyrd's payment processing capabilities with AI models like OpenAI and Anthropic Claude.

Overview

This toolkit enables AI assistants to perform payment operations through the Paybyrd API:

• Create payment links for customers
• Process refunds
• Retrieve order information

The toolkit uses a modular architecture with support for different AI platforms.

Repository Structure

This monorepo is organized into these packages:

• core (`@paybyrd/ai-agent-toolkit`): Core functionality and shared tools
• claude (`@paybyrd/ai-agent-claude`): Anthropic Claude integration using Model Context Protocol
• openai (`@paybyrd/ai-agent-openai`): OpenAI integration with function calling

Quick Start

Prerequisites

• Node.js 18 or higher
• Paybyrd API key
• OpenAI API key (for OpenAI integration) or Anthropic API key (for Claude integration)

Installation

Each package can be installed separately depending on which AI platform you're using:

# For the core functionality
npm install @paybyrd/ai-agent-toolkit

# For Claude integration
npm install @paybyrd/ai-agent-claude

# For OpenAI integration
npm install @paybyrd/ai-agent-openai

Examples

See the `/examples` directory for complete implementation examples:

• `/examples/openai`: Example implementation with OpenAI
• `/examples/modelcontextprotocol`: Example implementation with Claude using the Model Context Protocol

Available Tools

The toolkit provides these payment operations:

• Create Payment Link: Generate payment links to send to customers
• Create Refund: Process refunds for transactions
• Retrieve Order: Get details about an existing order

Development

# Install dependencies
npm install

# Build all packages
npm run build

# Run tests
npm test

License

MIT