Skip to main content

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 payments, analytics, disputes, customer operations, and free business utilities directly from MCP clients.

Installation​

npx mcp-paylinks

No global install needed. npx downloads and runs the server directly.

Configuration​

Environment Variables​

VariableRequiredDescription
PAYLINKS_API_TOKENYesYour JWT bearer token
PAYLINKS_API_BASE_URLNoAPI base URL (default: https://paylinks.ro)
PAYLINKS_API_TIMEOUT_MSNoRequest timeout in ms (default: 15000)

Claude Desktop​

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

{
  "mcpServers": {
    "paylinks": {
      "command": "npx",
      "args": ["-y", "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": ["-y", "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 61 public tools across 16 modules:

  • list_paylinks
  • get_paylink
  • create_paylink
  • update_paylink
  • delete_paylink
  • duplicate_paylink
  • toggle_paylink
  • ai_draft_paylink

Transactions (1)​

  • get_transactions

Analytics (5)​

  • get_analytics_summary
  • get_revenue
  • get_mrr
  • get_payment_methods
  • reconcile_analytics

Stripe (6)​

  • get_balance
  • get_payouts
  • create_payout
  • get_stripe_account
  • create_account_link
  • get_account_requirements

Customers (1)​

  • get_customers

Subscriptions (1)​

  • list_subscriptions

Disputes (3)​

  • list_disputes
  • get_dispute
  • submit_dispute_evidence

Email (7)​

  • list_broadcasts
  • create_broadcast
  • get_broadcast
  • send_broadcast
  • ai_draft_broadcast
  • list_subscribers
  • add_subscriber

Purchases (3)​

  • list_purchases
  • presign_download
  • cancel_purchase_subscription

Profile (3)​

  • get_me
  • update_me
  • complete_onboarding

Settings (2)​

  • get_settings
  • update_settings

Auth (2)​

  • request_magic_link
  • verify_magic_link

Uploads (1)​

  • presign_upload

Crypto (3)​

  • crypto_list_wallets
  • crypto_get_balance
  • crypto_create_payment_link

Public (3)​

  • list_public_paylinks
  • get_public_paylink
  • claim_free_paylink

Free Tools (12)​

  • free_generate_proforma_totals
  • free_convert_bank_statement_rows
  • free_verify_cui
  • free_generate_qr_payload
  • free_calculate_pfa_taxes
  • free_calculate_vat
  • free_calculate_net_income
  • free_compare_payment_commissions
  • free_calculate_hourly_rate
  • free_get_fiscal_calendar_events
  • free_quiz_pfa_vs_srl
  • free_split_bill

Available Resources​

The MCP server also exposes 3 resources:

  • paylinks://dashboard/stats
  • paylinks://activity/recent
  • paylinks://account/overview

Privileged Tools​

Privileged MCP operations are intentionally not listed in the public catalog and are only registered when the supplied API token has elevated permissions.

Example Conversations​

"Create a payment link for consulting at 500 RON, then show me this month's revenue and MRR."

The assistant can call create_paylink, get_revenue, and get_mrr.

"Draft and send an email campaign for Black Friday to all subscribers."

The assistant can call ai_draft_broadcast, create_broadcast, and send_broadcast.

"Run PFA vs SRL quiz and compare payment processor commissions for 10,000 RON/month."

The assistant can call free_quiz_pfa_vs_srl and free_compare_payment_commissions.

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 programmatic flow in Authentication.

MCP Server at a Glance​

The PayLinks MCP server exposes 61 public tools across 16 modules, plus 3 resources. It supports both stdio and SSE transport and runs via npx mcp-paylinks with zero installation. Privileged operations are available only for elevated tokens.

Frequently Asked Questions​

How do I install the MCP server?​

No installation is needed. Run npx mcp-paylinks and it downloads and executes automatically.

Which MCP clients are supported?​

The PayLinks MCP server works with any MCP-compatible client, including Claude Desktop, Cursor, Claude Code, and other Model Context Protocol clients.

Can I run the MCP server remotely?​

Yes. Use npx mcp-paylinks --sse --port 3100 and connect your MCP client to http://localhost:3100/sse.