Agent Toolkit

🚀 Visa Acceptance Agent Toolkit

The Visa Acceptance Agent Toolkit seamlessly integrates with Vercel's AI SDK and the Model Context Protocol (MCP) for Visa Acceptance APIs. It offers specialized tools to manage invoices, create payment links, and perform other Visa Acceptance-related operations.

🚀 Quick Start

The Visa Acceptance Agent Toolkit provides a set of tools for Visa Acceptance operations. It integrates well with Vercel's AI SDK and supports the Model Context Protocol (MCP).

✨ Features

• Full integration with Vercel AI SDK: Supports function calling and tool support.
• Complete MCP server implementation: Allows you to run a Visa Acceptance MCP server.

📦 Installation

If you simply want to use the toolkit without modifying its source code, install it via:

npm install @visaacceptance/agent-toolkit

Requirements

• Node 18+

💻 Usage Examples

Basic Usage

Configure the toolkit with your Visa Acceptance account credentials. These credentials can be set using environment variables (MERCHANT_ID, API_KEY_ID, SECRET_KEY).

import { VisaAcceptanceAgentToolkit } from "@visaacceptance/agent-toolkit/ai-sdk";

const toolkit = new VisaAcceptanceAgentToolkit({
  merchantId: process.env.VISA_ACCEPTANCE_MERCHANT_ID,
  apiKeyId: process.env.VISA_ACCEPTANCE_API_KEY_ID,
  secretKey: process.env.VISA_ACCEPTANCE_SECRET_KEY,
  configuration: {
    actions: {
      invoices: {
        create: true,
        update: true,
        list: true,
        get: true,
        send: true,
        cancel: true
      },
      paymentLinks: {
        create: true,
        update: true,
        list: true,
        get: true,
      },
    },
  },
});

Advanced Usage

Integrating with Vercel's AI SDK

To use this toolkit with Vercel's AI SDK:

import { AI } from "@vercel/ai";
import { VisaAcceptanceAgentToolkit } from "@visaacceptance/agent-toolkit/ai-sdk";

const toolkit = new VisaAcceptanceAgentToolkit({
  merchantId: process.env.MERCHANT_ID,
  apiKeyId: process.env.API_KEY_ID,
  secretKey: process.env.SECRET_KEY,
  configuration: {
    actions: {
      invoices: {
        create: true,
      }
    },
  },
});

const ai = new AI({
  tools: toolkit.getTools(),
});

// Sample usage:
const response = await ai.run({
  messages: [{ role: "user", content: "Please create an invoice for $200" }],
});

Setting Context

You can set default behaviors or environments via the configuration.context block. For example, enabling test environments:

const toolkit = new VisaAcceptanceAgentToolkit({
  merchantId: process.env.MERCHANT_ID,
  apiKeyId: process.env.API_KEY_ID,
  secretKey: process.env.SECRET_KEY,
  configuration: {
    context: {
      environment: "SANDBOX",
    },
  },
});

📚 Documentation

Model Context Protocol

The Model Context Protocol (MCP) is also supported. You can run a Visa Acceptance MCP server with:

npx -y @visaacceptance/mcp --tools=all --merchant-id=YOUR_MERCHANT_ID --api-key-id=YOUR_API_KEY_ID --secret-key=YOUR_SECRET_KEY

Supported API Methods

The toolkit currently provides the following Visa Acceptance operations:

• Invoices

  • Create an invoice: Create a new invoice with customer information and enhanced parameters.
  • Update an invoice: Update existing invoice details including customer and invoice information.
  • List invoices: Retrieve paginated list of invoices with filtering options.
  • Get invoice: Retrieve detailed information for a specific invoice.
  • Send invoice: Send invoice to customer via email.
  • Cancel invoice: Cancel an existing invoice.

• Payment Links

  • Create a payment link: Create a new payment link with optional shipping information.
  • Update a payment link: Update existing payment link details.
  • List payment links: Retrieve paginated list of payment links.
  • Get payment link: Retrieve details of a specific payment link.

📄 License

This project is licensed under the MIT License.

⚠️ Important Note

AI-generated content may be inaccurate or incomplete. Users are fully responsible for verifying any information before relying on it, especially for financial decisions. Visa Acceptance is not liable for any usage, decisions, or damages resulting from AI outputs or this toolkit.