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