What is Paystack Mcp

Paystack MCP is a Model Context Protocol server that enables AI agents to interact with Paystack services through standardized MCP clients using tool calling.

Use cases

Use cases include managing an online store, processing payments for services, handling customer data, and generating transaction reports.

How to use

To use Paystack MCP, install it via Smithery or manually, then start the server with the command ‘paystack-mcp’. Ensure to set your Paystack secret key in the environment variables.

Key features

Key features include product management, customer management, transaction processing, authorization management, access to bank information, and transaction data export.

Where to use

Paystack MCP can be used in e-commerce platforms, financial applications, and any service requiring payment processing and customer management.

Paystack MCP Server

The Paystack Model Context Protocol (MCP) server allows AI agents to interact with Paystack through standardized MCP clients via tool calling. This protocol supports various tools to interact with different Paystack services.

Features

• Create and manage products in your Paystack store
• Handle customer management (create, list, update, validate)
• Process transactions (initialize, verify, charge authorization)
• Manage authorizations and payments
• Access bank information and country data
• Export transaction data and view transaction totals

Setup

Make sure to replace your_paystack_secret_key_here with your actual Paystack secret key.

npx -y @smithery/cli install @kohasummons/paystack-mcp --client claude

npm install -g @kohasummons/paystack-mcp

paystack-mcp

{
  "mcpServers": {
    "paystack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@kohasummons/paystack-mcp"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "your_paystack_secret_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "paystack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@kohasummons/paystack-mcp"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "your_paystack_secret_key_here"
      }
    }
  }
}

goose://extension?cmd=npx&arg=-y&arg=@kohasummons/paystack-mcp&id=paystack-mcp&name=Paystack%20MCP&description=process%20payments%20with%20Paystack

npm install -g @kohasummons/paystack-mcp

export PAYSTACK_SECRET_KEY=your_paystack_secret_key_here  # For macOS/Linux
# OR
set PAYSTACK_SECRET_KEY=your_paystack_secret_key_here     # For Windows

paystack-mcp

PAYSTACK_SECRET_KEY=your_paystack_secret_key_here npx -y @kohasummons/paystack-mcp

{
  "mcpServers": {
    "paystack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@kohasummons/paystack-mcp"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "your_paystack_secret_key_here"
      }
    }
  }
}

docker-compose build

docker-compose up -d

{
  "mcpServers": {
    "paystack-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "PAYSTACK_SECRET_KEY=your_paystack_secret_key_here",
        "kohasummons/paystack-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "paystack-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "PAYSTACK_SECRET_KEY=your_paystack_secret_key_here",
        "kohasummons/paystack-mcp"
      ]
    }
  }
}

Tools

Products

Customers

Transactions

Banking Information

Contributing

We welcome contributions to help improve this project and implement the remaining Paystack API endpoints! There are many more Paystack features that could be added as tools, including:

• Payment Pages
• Subaccounts
• Plans
• Subscriptions
• Apple Pay
• Virtual Accounts
• Invoices
• Refunds
• And more!

See CONTRIBUTING.md for detailed instructions on how to contribute, including:

• Setting up your development environment
• Guide for implementing new tools
• Code style guidelines
• Pull request process

Development

To work on this project:

1. Clone the repository
2. Install dependencies: npm install
3. Build the project: npm run build
4. Run the Inspector: npm run dev:debug

You’ll need to set up your Paystack secret key as an environment variable:

# Create a .env file in the project root
echo "PAYSTACK_SECRET_KEY=your_paystack_secret_key_here" > .env

Debugging

To debug your server, you can use the MCP Inspector.

First build the server

npm run build

Run the following command in your terminal:

# Start MCP Inspector and server
npm run dev:debug

Add your PAYSTACK_SECRET_KEY to the enviroment variable in the Inspector UI. Debug away!

Docker Support

See DOCKER.md for details on building and running with Docker.

License

MIT