Mayar MCP server
Commit Nov 12, 2026Connects AI agents to Mayar accounts to manage invoices, payment links, products, customers, transactions, and QRIS.
Also known as mayarid/mayar-agent-plugin, mayar-agent-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is Mayar MCP?
Mayar connects AI agents to Mayar accounts to manage invoices, payment links, products, customers, transactions, and QRIS.
Summary generated from the project's README
About Mayar MCP server
Mayar provides a connection between AI agents and Mayar accounts to facilitate business management through automated tool calls. This server operates as a hosted service at mcp.mayar.id/mcp and requires a production API key from the Mayar dashboard to function. Users can integrate this plugin into the Hermes Agent by installing the mayarid/mayar-agent-plugin package and configuring the MAYAR_API_KEY in their environment file.
Developers use this interface to allow models to interact with various business domains including invoices, products, customers, and transactions. The system includes specific tools for managing memberships, coupons, webhooks, reviews, QRIS, and license codes. Because write actions involve real money and live data, the Hermes client treats this as an untrusted server and requests user permission before executing any command that can create or update records like payment links or customer details.
What you can do with it
- 1Check account balanceAsk the AI agent to retrieve your current account balance using the account tool.
- 2Manage business assetsInstruct an agent to create or update invoices, products, and coupons within your account.
- 3Monitor financial activityHave an AI client read through your recent transactions and customer data.
Written from the project's README. Every use case is checked against a quote from it.
How to install Mayar MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Mayar MCP in Claude Code
$ claude mcp add --transport http mayar-agent-plugin https://mcp.mayar.id/mcpInstall Mayar MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mayar-agent-plugin": {
"url": "https://mcp.mayar.id/mcp"
}
}
}Install Mayar MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mayar-agent-plugin": {
"type": "http",
"url": "https://mcp.mayar.id/mcp"
}
}
}Install Mayar MCP in VS Code CLI
$ code --add-mcp '{"name":"mayar-agent-plugin","type":"http","url":"https://mcp.mayar.id/mcp"}'Install Mayar MCP in Codex
$ codex mcp add mayar-agent-plugin --url https://mcp.mayar.id/mcpInstall Mayar MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mayar-agent-plugin] url = "https://mcp.mayar.id/mcp"
Install Mayar MCP in Gemini CLI
$ gemini mcp add -s user --transport http mayar-agent-plugin https://mcp.mayar.id/mcpInstall Mayar MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mayar-agent-plugin": {
"url": "https://mcp.mayar.id/mcp",
"type": "http"
}
}
}Configuration
MAYAR_API_KEY
| Name | Description | |
|---|---|---|
| MAYAR_API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemayarid/mayar-agent-plugin is public and reachablegithub.com/mayarid/mayar-agent-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/mayarid/mayar-agent-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubMayar 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. Cursor and
cursor.directory read that root file. It uses Cursor's
${env:MAYAR_API_KEY} syntax. Do not change it for Claude Code.
Install in Claude Code
This repository also ships a Claude plugin in plugins/mayar (manifest, skill, license, and a
Claude .mcp.json). Anthropic's directory can list that subfolder through the submission
"Plugin path" field. The root .mcp.json stays the Cursor file, because the two clients
authenticate differently.
Claude Code requires "type": "http" on a remote server. The plugin file at
plugins/mayar/.mcp.json sends Authorization: Bearer ${user_config.mayar_api_key}.
Claude Code asks for that key when you install or enable the plugin in a session. It
stores the key outside settings.json (macOS Keychain, or ~/.claude/.credentials.json with mode 600 on Linux). It does not read MAYAR_API_KEY from the environment,
and it does not expand ${env:MAYAR_API_KEY}.
Load the plugin from a local clone:
claude --plugin-dir ./plugins/mayar
Or add this repository as a marketplace and install mayar:
claude plugin marketplace add mayarid/mayar-agent-plugin
claude plugin install mayar@mayarid
A --plugin-dir or shell install does not open the key dialog. In a Claude Code
session, run /plugin configure on the installed plugin to set the key. For a
marketplace install, that command is /plugin configure mayar@mayarid. You can
also pass --config mayar_api_key=YOUR_KEY to claude plugin install. See
Claude Code under Set your API key.
You can still add the server by hand with claude mcp add (see Claude Code under Set your API
key). Mayar has no OAuth. On claude.ai and in Cowork, the plugin skill loads, but the Connectors
tab expects an OAuth sign-in that Mayar does not offer, so tool calls there cannot authenticate
with an API key the way Claude Code can.
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
When you install or enable the plugin in a Claude Code session, Claude Code asks
for your production API key and stores it outside settings.json (macOS Keychain, or ~/.claude/.credentials.json with mode 600 on Linux). To set or change
the key later, run /plugin configure mayar@mayarid in a session. Get a key
from https://web.mayar.id/api-keys.
If you installed the plugin from the shell, Claude Code does not prompt for the
key. Pass --config mayar_api_key=YOUR_KEY on install, or run /plugin configure mayar@mayarid afterward and restart Claude Code.
If you installed the plugin in plugins/mayar, Claude Code reads
Authorization: Bearer ${user_config.mayar_api_key} from that folder's
.mcp.json. To add the server by hand instead:
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. This by-hand
server does not use the plugin's userConfig field.
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_KEYin the client. This package'smcp.jsondoes not include anAuthorizationheader.
License
MIT
Mayar MCP questions
How do I add Mayar MCP to Claude Code?
Run claude mcp add --transport http mayar-agent-plugin https://mcp.mayar.id/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Mayar MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can the agent do with Mayar?
The agent can read and manage invoices, payment links, products, customers, transactions, memberships, coupons, webhooks, reviews, QRIS and license codes.
How do I install this in Hermes Agent?
Install using the hermes plugins install command and then enable the plugin, ensuring your API key is added to your ~/.hermes/.env file.
Does the plugin store my credentials?
No, the plugin does not store credentials; it reads the API key from the Hermes environment.
