Mayar

Mayar Agent Plugin

Connect an AI agent to your Mayar account. This package uses Mayar's official hosted MCP server at https://mcp.mayar.id/mcp. With it, the agent can read and manage invoices, payment links, products, customers, transactions, memberships, coupons, webhooks, reviews, QRIS and license codes.

This is a Portable Agent Plugins v1 package (plugin.json, mcp.json and skills/). It is configuration only. It contains no executable code.

Requirements

• A Mayar account.
• A production API key. Get it in the Mayar dashboard under Integration > Api Keys (web.mayar.id/api-keys).

Install in Hermes Agent

hermes plugins install mayarid/mayar-agent-plugin --no-enable
hermes plugins enable mayar

Set your API key (see below). Restart Hermes. Then ask: "Use Mayar. Call the account tool with action balance." A working key returns your balance.

Install in Cursor

The button adds Mayar's hosted MCP server to Cursor. Set MAYAR_API_KEY first (see below). This repository also includes a Cursor config file at .mcp.json.

Set your API key

Mayar does not use OAuth. Every client sends your production API key in the Authorization header. Get the key in the Mayar dashboard: Integration > Api Keys (web.mayar.id/api-keys).

Cursor

Set the MAYAR_API_KEY environment variable. The Add to Cursor button and .mcp.json send it as Authorization: Bearer ${env:MAYAR_API_KEY}.

Hermes

Put the key in ~/.hermes/.env, or set it in the plugin settings form:

MAYAR_API_KEY=your-production-key

Agent Plugins v1.0.0 does not allow secrets or placeholders in mcp.json remote headers. Hermes does not yet attach this key from the plugin extension alone. Add this block to your Hermes config.yaml so Hermes sends the header. A same-name entry replaces the package server, so keep trust: untrusted:

mcp_servers:
  mayar:
    url: https://mcp.mayar.id/mcp
    headers:
      Authorization: "Bearer ${MAYAR_API_KEY}"
    trust: untrusted

Claude Code

Set MAYAR_API_KEY, then run:

claude mcp add --transport http mayar https://mcp.mayar.id/mcp \
  --header "Authorization: Bearer $MAYAR_API_KEY"

The shell expands $MAYAR_API_KEY when you run the command.

Other clients

The same server works in any MCP client that speaks Streamable HTTP. Send the key in the Authorization header. The Bearer prefix is optional. The server URL is https://mcp.mayar.id/mcp.

Tools

Each domain is one tool with an action argument: account, invoice, installment, customer, transaction, product, payment, membership, credit, coupon, webhook, review, qr, license and search_docs. The full reference is at mcp.mayar.id/docs.

Disclosure

• Every tool call goes to https://mcp.mayar.id, which calls the Mayar production API (api.mayar.id) with your key.
• Write actions use real money and live data. They can create or update invoices, payment links, products, customers and coupons, change membership status, change the webhook URL and add or spend credits.
• The package marks the server untrusted. Hermes asks you before each write-capable call.
• Account data that the tools return (customers, transactions, balances) goes to your model provider.
• The tool list comes from the server at run time. The pinned commit does not cover it.
• The plugin stores no credentials. You set MAYAR_API_KEY in the client. This package's mcp.json does not include an Authorization header.

License

MIT