Agent-Toolkit | Visa Acceptance Developer Portal

Product overview

The Visa Acceptance Agent Toolkit is a developer-friendly SDK that bridges our product APIs with AI-driven applications.

It allows you to integrate Visa Acceptance features (like creating invoices or pay-by-links) using natural language or function calls.

The toolkit can be used in two ways:

Directly via an AI SDK (e.g., Vercel AI SDK) – Integrate the toolkit as a library in your code, enabling function-calling from your AI agents in a Node.js/TypeScript environment

Via an MCP (Model Context Protocol) server – Run the toolkit as a service that AI assistants (like Claude Desktop) can connect to and use without writing integration code

Prerequisites:

Before you begin, ensure you have the following prerequisites in place :

Node.js version 18 or higher

Development Environment - such as Claude Desktop

Visa Acceptance Merchant OrganizationID (MID) - You can signup for a sandbox here

Visa acceptance Rest API Shared secret keys

Visa acceptance agent toolkit repo

Seamless integration with Vercel's AI SDK and Model Context Protocol (MCP)
Specialized tools for invoice and payment link management
Support for TypeScript and Node 18+
Function calling, tool support, and local MCP server setup
·Secure and scalable infrastructure for enterprise solutions

Getting started

Provide Your Credentials

The toolkit requires your Visa acceptance credentials to authenticate API calls. Configure these as environment variables

Create a new `.env` file and insert the below code snippet.

                VISA_ACCEPTANCE_MERCHANT_ID=your_merchant_id_here
VISA_ACCEPTANCE_API_KEY_ID=your_api_key_id_here
VISA_ACCEPTANCE_SECRET_KEY=your_secret_key_here

For MCP mode: If launching via npx, you’ll pass these as command-line args or have them in an env file. (We’ll show this in the next step.)

Configure integration method

Now set up either the AI SDK integration in your code or prepare to run the MCP server:

AI toolkit configuration :

                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: {
    context: {
      environment: "SANDBOX",
    },
    actions: {
      invoices: {
        create: true,
        update: true,
        list: true,
        get: true,
        send: true,
        cancel: true
      },
      paymentLinks: {
        create: true,
        update: true,
        list: true,
        get: true,
      },
    },
  },
});

MCP toolkit : You’ll run the toolkit as a local MCP server that tools like Claude can connect to.

This usually means adding an entry in the AI tool’s config.

For example, in Claude Desktop, open claude_desktop_config.json and add :

                {
  "mcpServers": {
    "visa-acceptance": {
      "command": "npx",
      "args": [
          "-y",
          "@visaacceptance/mcp",
          "--tools=all",
          "--merchant-id=YOUR_MERCHANT_ID",
          "--api-key-id=YOUR_API_KEY_ID",
          "--secret-key=YOUR_SECRET_KEY"
      ]
    }
  }
}

This tells Claude Desktop to use the Visa acceptance agent toolkit with your Visa acceptance API credentials

                npx -y @visaacceptance/mcp --tools=all --merchant-id=MERCHANT_ID --api-key-id=API_KEY_ID --secret-key=SECRET_KEY

or 

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