Payhere MCP server

Connect Payhere to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Payhere MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get customer tool in Payhere
  • Use the update plan tool in Payhere
  • Use the refund payment tool in Payhere
  • Use the create plan tool in Payhere
  • Use the list plans tool in Payhere
  • Use the get company tool in Payhere

Supported Tools

get_customer

Get Customer

Fetch detailed information about a specific customer by their ID.

update_plan

Update Plan

Update an existing payment plan's configuration. Supports modifying pricing, billing settings, visibility, and display options.

refund_payment

Refund Payment

Issue a full or partial refund for an existing payment. Requires specifying the payment, amount to refund, and a reason.

create_plan

Create Plan

Create a new payment plan for collecting one-off or recurring payments. Supports configuring pricing, billing intervals, setup fees, donation mode, and more.

list_plans

List Plans

Retrieve a paginated list of payment plans. Plans represent products or services that customers can pay for, including one-off payments and recurring subscriptions.

get_company

Get Company

Retrieve the current company's profile and statistics. Returns company details along with payment stats for the last 30 days.

update_company

Update Company

Update the current company's profile settings, including display name, legal name, address, contact information, and branding options shown on receipts and payment pages.

list_subscriptions

List Subscriptions

Retrieve a paginated list of subscriptions, ordered by most recent payment first. Includes associated customer and plan data.

cancel_subscription

Cancel Subscription

Stop future billing for a subscription. The subscription remains active until the current billing period ends.

list_payments

List Payments

Retrieve a paginated list of payments, ordered chronologically with most recent first. Use **Get Payment** to fetch full details including customer and subscription data for a specific payment.

list_customers

List Customers

Retrieve a paginated list of customers, ordered chronologically with most recent first. Customers are created automatically when they make a payment.

get_payment

Get Payment

Fetch detailed information about a specific payment, including associated customer, subscription, and plan data.

get_subscription

Get Subscription

Retrieve a subscription by ID, including its customer, plan, and payment history.

who_am_i

Who Am I

Retrieve the currently authenticated Payhere user and verify which account the API key belongs to.

Connect Payhere to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Payhere in Metorial. In your Metorial portal, enable the Payhere MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Payhere tools.

Run Payhere through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Payhere and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Payhere tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Payhere

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Freeagent

Manage FreeAgent contacts, invoices, estimates, supplier bills, expenses, projects, tasks, and timeslips. Browse bank accounts and transactions, identify the connected user, download invoice PDFs, and retrieve financial reports.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Technical notes for Payhere

Manage payment plans, subscriptions, customers, and refunds. Create and update one-off or recurring payment plans with configurable pricing, billing intervals, and setup fees. List and view payments, customer records, and subscription details. Cancel subscriptions and issue full or partial refunds. Retrieve company profile and statistics.

Frequently asked questions

Common questions about connecting Payhere to AI agents with Metorial.

  1. How many tools does the Payhere MCP server have?
    The Payhere MCP server exposes 14 tools, including Get Customer, Update Plan, Refund Payment. Each one is governed and traced through Metorial.
  2. Payhere exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Payhere MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Payhere and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Payhere MCP server yourself or use the hosted gateway.

Connect Payhere to production AI agents

See how Metorial gives your team governed access to Payhere, with tracing and security controls built in.