Finix MCP

🚀 Finix MCP Server (Unofficial)

An unofficial, local MCP (Model Context Protocol) server that simplifies access to Finix payment processing functionality.

⚠️ Important Note

This is an unofficial, community-built MCP server. It is not affiliated with or endorsed by Finix.

🚀 Quick Start

This server provides simplified access to Finix payment processing functionality. You can search documentation, manage identities, create payment links, etc.

✨ Features

• Documentation Search: Search Finix documentation through an MCP-compatible interface.
• Identity Management: Create and list buyers and sellers with simplified parameters.
• Payment Links: Create payment links with just merchant ID, price, and quantity.
• Streamlined API: All tools use simple parameters for ease of use and reduced token usage.

📦 Installation

npm install

📚 Documentation

Configuration

Set your Finix credentials and environment:

export FINIX_USERNAME="your-username"
export FINIX_PASSWORD="your-password"
export FINIX_ENVIRONMENT="Sandbox"  # or "Live"

Environment options:

• Sandbox (default) - Uses https://finix.sandbox-payments-api.com.
• Live or Production - Uses https://finix.live-payments-api.com.

Usage

Running the Server

Start the MCP server:

npm start

For development with auto-reload:

npm dev

Build TypeScript

npm run build

Integrating with Claude Code

Add this configuration to your Claude Code mcp file:

{
  "mcpServers": {
    "finix-docs": {
      "command": "npx",
      "args": ["tsx", "/path/to/finix-mcp/server.ts"],
      "env": {
        "FINIX_USERNAME": "your-username",
        "FINIX_PASSWORD": "your-password",
        "FINIX_ENVIRONMENT": "Sandbox" //Or 'Live' for Live
      }
    }
  }
}

Available Tools

search_finix_docs

Search the Finix documentation for relevant information.

create_buyer

Create a new buyer identity with essential information.

create_seller

Create a new seller identity with comprehensive business information.

list_buyers

Fetch a list of buyers with simple filtering.

list_sellers

Fetch a list of sellers with simple filtering.

create_payment_link

Create a payment link for processing payments.

🔧 Technical Details

The server is built with:

• TypeScript for type safety.
• @modelcontextprotocol/sdk for MCP implementation.
• Native fetch API for HTTP requests.
• StdioServerTransport for communication.

📄 License

ISC