MCP Server

Connect PayLinks to Claude Desktop, Cursor, and other MCP-compatible AI tools.

What is MCP?

The Model Context Protocol (MCP) is a standard for connecting AI assistants to external tools and data sources. The PayLinks MCP server lets you manage your payments through Claude Desktop and other MCP clients.

Installation

npx mcp-paylinks

No global install needed — npx runs it directly.

Configuration

Environment Variables

Variable	Required	Description
PAYLINKS_API_TOKEN	Yes	Your JWT bearer token
PAYLINKS_API_BASE_URL	No	API base URL (default: https://api.paylinks.ro/api/v1)

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "paylinks": {
      "command": "npx",
      "args": ["mcp-paylinks"],
      "env": {
        "PAYLINKS_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "paylinks": {
      "command": "npx",
      "args": ["mcp-paylinks"],
      "env": {
        "PAYLINKS_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

SSE Transport

For remote connections, the MCP server supports SSE (Server-Sent Events) transport:

PAYLINKS_API_TOKEN=your-token npx mcp-paylinks --sse --port 3100

Then connect your MCP client to http://localhost:3100/sse.

Available Tools

The MCP server exposes 41 tools:

Payment Links (7)

• list_paylinks — List all payment links
• get_paylink — Get paylink by ID
• create_paylink — Create a payment link
• update_paylink — Update a paylink
• delete_paylink — Delete a paylink
• duplicate_paylink — Duplicate a paylink
• ai_draft_paylink — AI-generate from prompt

Transactions (2)

• list_transactions — List transactions
• refund_transaction — Refund a transaction

Customers (1)

• list_customers — List customers by segment

Analytics (5)

• get_analytics_summary — Dashboard summary
• get_revenue_data — Revenue over time
• get_mrr_data — Monthly recurring revenue
• get_payment_methods — Payment methods breakdown
• trigger_reconciliation — Reconcile with Stripe

Stripe (6)

• get_stripe_balance — Account balance
• list_stripe_payouts — List payouts
• create_stripe_payout — Create a payout
• get_stripe_account — Connected account
• get_stripe_requirements — Verification requirements
• create_stripe_account_link — Onboarding link

Disputes (3)

• list_disputes — List disputes
• get_dispute — Get dispute
• submit_dispute_evidence — Submit evidence

Settings (2)

• get_settings — Get settings
• update_settings — Update settings

Subscriptions (1)

• list_subscriptions — List subscriptions

Purchases (3)

• list_purchases — List purchases
• download_purchase — Get download URL
• cancel_subscription — Cancel subscription

Email (6)

• list_broadcasts — List broadcasts
• create_broadcast — Create broadcast
• send_broadcast — Send broadcast
• ai_draft_broadcast — AI draft broadcast
• list_subscribers — List subscribers
• add_subscriber — Add subscriber

Profile (2)

• get_profile — Get current user
• update_profile — Update profile

Uploads (1)

• presign_upload — Get presigned upload URL

Public (2)

• list_public_paylinks — List public paylinks
• get_public_paylink — Get public paylink

Example Conversations

With Claude Desktop:

"Show me my PayLinks dashboard summary"

Claude calls get_analytics_summary and presents your revenue, transactions, and customer count.

"Create a payment link for consulting at 500 RON per hour"

Claude calls create_paylink with the right parameters.

"Draft and send an email to all subscribers about our Black Friday sale"

Claude calls ai_draft_broadcast, shows the draft, and on approval calls send_broadcast.

Getting Your Token

1. Go to paylinks.ro and sign in
2. Open browser DevTools (F12)
3. Go to Application > Local Storage > https://paylinks.ro
4. Copy the token value

Or use the magic link flow programmatically (see Authentication).

MCP Server at a Glance

The PayLinks MCP server exposes 41 tools across 12 modules: Payment Links (7), Transactions (2), Customers (1), Analytics (5), Stripe (6), Disputes (3), Settings (2), Subscriptions (1), Purchases (3), Email (6), Profile (2), Uploads (1), and Public (2). It supports both stdio and SSE transport protocols and runs via npx mcp-paylinks with zero installation.

Frequently Asked Questions

How do I install the MCP server?

No installation is needed. Run npx mcp-paylinks and it downloads and executes automatically. For Claude Desktop, add the server to your claude_desktop_config.json. For Cursor, add it to .cursor/mcp.json.

Which MCP clients are supported?

The PayLinks MCP server works with any MCP-compatible client including Claude Desktop, Cursor, Claude Code, and other tools that support the Model Context Protocol. Both stdio (local) and SSE (remote) transport protocols are supported.

Can I run the MCP server remotely?

Yes. Use npx mcp-paylinks --sse --port 3100 to start the server with SSE transport. Then connect your MCP client to http://localhost:3100/sse. This enables remote connections and shared server instances.