Authorize Net MCP

🚀 authorize-net-mcp Project Documentation

This is a server project based on the Model Context Protocol (MCP), integrating the Authorize.net Node SDK. It offers two main payment functionalities:

1. takePayment - Immediately deduct funds (AUTH_CAPTURE).
2. createInvoice - Generate a hosted invoice page for customers to make online payments.

✨ Features

• Immediate Payment Deduction (takePayment): Supports direct deduction of a specified amount from the customer's credit card.
• Invoice Generation (createInvoice): Creates a hosted page link through which customers can enter payment information to complete the transaction.

📚 Documentation

Introduction to Model Context Protocol (MCP)

MCP is a protocol for connecting models with context data, allowing interactions in different environments. Through MCP, various tools and services can be conveniently invoked.

Project Structure

project/
├── src/                 # Source code directory
│   ├── authorize-net.ts # Integration implementation of Authorize.net
│   └── mcp-server.ts    # Main logic of the MCP server
├── package.json         # Project dependencies and script configuration
└── README.md            # Project documentation

Startup Steps

1. Install Dependencies

npm install

2. Set Environment Variables Set the Authorize.net API key and configuration according to your operating system as follows:

• Linux/MacOS:

export AUTHORIZE_NET_API_KEY=your_api_key_here
export AUTHORIZE_NET_CONFIG=path_to_your_config.json

• Windows (Command Line):

set AUTHORIZE_NET_API_KEY=your_api_key_here
set AUTHORIZE_NET_CONFIG=path_to_your_config.json

• PowerShell:

$env:AUTHORIZE_NET_API_KEY="your_api_key_here"
$env:AUTHORIZE_NET_CONFIG="path_to_your_config.json"

3. Start the Server

npm start

Using MCP Tools

List Available Tools

Invoke the following command to get all available MCP tools and their detailed information:

{
  "command": "list_tools"
}

Example response:

{
  "tools": [
    {
      "name": "takePayment",
      "description": "Immediately deduct funds from the customer's credit card.",
      "parameters": [
        { "name": "amount", "type": "number", "required": true },
        { "name": "cardNumber", "type": "string", "required": true },
        { "name": "expirationDate", "type": "string", "required": true },
        { "name": "cardCode", "type": "string", "required": true }
      ]
    },
    {
      "name": "createInvoice",
      "description": "Create a hosted page link for customers to make online payments.",
      "parameters": [
        { "name": "amount", "type": "number", "required": true },
        { "name": "invoiceNumber", "type": "string", "required": true },
        { "name": "description", "type": "string", "required": true }
      ]
    }
  ]
}

Invoke the takePayment Tool

Example request:

{
  "command": "execute_tool",
  "tool_name": "takePayment",
  "args": {
    "amount": 19.99,
    "cardNumber": "4242424242424242",
    "expirationDate": "0825",
    "cardCode": "123"
  }
}

Example response:

{
  "status": "success",
  "transaction_id": "T20231017-123456"
}

Invoke the createInvoice Tool

Example request:

{
  "command": "execute_tool",
  "tool_name": "createInvoice",
  "args": {
    "amount": 50.0,
    "invoiceNumber": "INV-1001",
    "description": "T-shirt order"
  }
}

Example response:

{
  "status": "success",
  "url": "https://checkout.authorize.net/your_invoice_id"
}

Important Notes

⚠️ Important Note

Do not commit real API keys to the code repository. It is recommended to use environment variables or professional key management tools.

⚠️ Important Note

When deploying in a production environment, ensure the use of HTTPS or other secure protocols to protect communication.

Further Reading

• MCP TypeScript SDK (GitHub)
• Authorize.net Developer Documentation

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file in the project.