# Payhere — MCP server on mcp.ai
> Connect your Payhere account and use 13 tools for ecommerce straight from your AI agent. Connect with your own API key. Easy payment links for accepting online payments.

By: mcp.ai · official
Page: https://mcp.ai/payhere

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_payhere?ms=1787296080000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/payhere/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/payhere/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/payhere/skill.md
Postman collection (v2.1): https://mcp.ai/payhere/postman.json

## Tools
- payhere_create_hook(post_url: string, resource: string, integration: string) — Tool to subscribe to a REST hook for receiving webhook events. Use when you need to register a webhook endpoint to receive real-time notifications for payment_received, subscription_cancelled, or subs
- payhere_create_plan(name: string, price?: number, hidden?: boolean, currency: string, show_qty?: boolean, setup_fee?: number, billing_day?: integer, description?: string, success_url?: string, webhook_url?: string, cancel_after?: integer, payment_type: string, receipt_text?: string, pay_button_text?: string, billing_interval?: string, min_billing_cycles?: integer, user_selects_amount?: boolean) — Tool to create a new payment plan in PayHere. Use when you need to set up either a recurring subscription or one-off payment plan for accepting payments.
- payhere_delete_hook(id: integer) — Tool to remove a REST hook listener subscription. Use when you need to stop receiving webhook events for a specific hook.
- payhere_get_current_company() — Tool to fetch company information for the currently authenticated user. Use when you need to retrieve comprehensive company details including identity, configuration, integration status, and associate
- payhere_get_current_company_stats() — Tool to fetch payment statistics for the last 30 days with comparison data from the preceding 30-day period (30-60 days ago). Use when you need to analyze recent payment trends, subscriber growth, or 
- payhere_get_user() — Tool to fetch information on the currently authenticated user. Use when you need to retrieve details about the logged-in user.
- payhere_list_customers(page?: integer, per_page?: integer) — Tool to list all customers from Payhere, ordered chronologically with most recent first. Use when you need to retrieve customer records, browse customers, or access customer information. Supports pagi
- payhere_list_hooks() — Tool to list all active REST hooks subscriptions for the authenticated company. Use when you need to view all currently registered webhook listeners for your PayHere account.
- payhere_list_payments(page?: integer, per_page?: integer) — Tool to list all payments ordered chronologically, most recent first. Use when you need to retrieve payment history or check payment statuses. Supports pagination with page and per_page parameters.
- payhere_list_plans(page?: integer, per_page?: integer) — Tool to list all plans in your PayHere account. Use when you need to retrieve and paginate through available plans.
- payhere_list_subscriptions(page?: integer, per_page?: integer) — Tool to list all subscriptions ordered chronologically by most recent payment first. Use when you need to retrieve subscription data with customer and plan details.
- payhere_update_current_company(logo?: object, name?: string, address?: string, website?: string, legal_name?: string, button_text?: string, button_color?: string, support_email?: string) — Tool to update the company information for the currently authenticated user. Use when modifying company details such as name, legal name, address, logo, support email, website, or branding preferences
- payhere_update_plan(id: string, name?: string, price?: number, hidden?: boolean, currency?: string, show_qty?: boolean, setup_fee?: number, billing_day?: integer, description?: string, success_url?: string, webhook_url?: string, cancel_after?: integer, receipt_text?: string, pay_button_text?: string, min_billing_cycles?: integer) — Tool to update an existing plan's configuration and settings. Use when you need to modify plan properties like name, description, pricing, or other settings for both one-off and subscription plans.

## Example prompts
- "What can I do in Payhere?"
- "Show me a summary of my Payhere account"

## Links
Docs: https://mcp.ai/docs/mcps/payhere
Website: https://mcp.ai/mcps/payhere