Use Nayax Agent Skills

Agent skills are instruction packages that AI coding agents load on demand. Each Nayax skill covers one API area and steers your agent toward the correct endpoints, request shapes, and known pitfalls of that area, so you get accurate integration guidance instead of guesswork.

Available skills

Nayax skills are published in the nayax-ai GitHub repository. The following skills are available today:

Skill	What it covers
`nayax-lynx-inventory`	Lynx product inventory: product groups, products, machine mapping, and pick lists for restocking.
`nayax-lynx-prepaid-cards`	Prepaid and virtual cards: creation, credit and revalue, balances, transfers, and lookup.
`nayax-lynx-refunds`	Refund workflow: request a refund, upload documentation, and approve or decline.
`nayax-lynx-reports`	Dashboard widgets and per-machine reporting: status, statistics, last sales, and change logs.

These cover the main Lynx API areas. Install any of them with the steps below.

Prerequisites

Before you install a skill, you’ll need:

An AI coding agent that supports agent skills, such as Claude Code, Cursor, or another tool compatible with the SKILL.md format.
A Lynx user token, if you want your agent to run real API calls. See Security & Token for how to get one.

Install skills

The skills CLI works with any compatible agent and is the simplest way to start. If you use Claude Code, you can install skills as a plugin instead, which keeps them updated automatically.

Skills work on their own. They don’t need the Nayax MCP server to be connected, and the MCP server doesn’t need any skills installed.

skills CLI (recommended)
Claude Code

The skills CLI installs skills for Claude Code, Cursor, and other compatible agents. Run it in your project folder.Choose what to install from an interactive list:

npx skills add writechoiceorg/nayax-ai

Install every Nayax skill at once, with no prompts:

npx skills add writechoiceorg/nayax-ai --all

Install specific skills by repeating the --skill flag:

npx skills add writechoiceorg/nayax-ai --skill nayax-lynx-inventory --skill nayax-lynx-refunds

Add the Nayax plugin marketplace, then install the skills you want as plugins:

claude plugin marketplace add writechoiceorg/nayax-ai
claude plugin install nayax-lynx-inventory@nayax

Install additional skills by repeating the last command with their names, for example nayax-lynx-refunds@nayax. Installed skills are available in every Claude Code session.

What you can do with a skill

Once installed, your agent loads the skill automatically when your prompt touches its area. For example, with nayax-lynx-inventory you can ask:

Create a product group called Beverages and add three products to it in the Lynx sandbox.

Map my products to machine 12345 and generate a pick list.

The agent follows the correct workflow order, such as creating product groups before products, and knows about behavior that often trips up integrations, like endpoints that return an empty body on success.

Pair skills with the MCP server

Skills and the Nayax MCP server complement each other. A skill carries curated workflow knowledge for one API area, while the MCP server gives your agent live search access to the full developer portal. For the best results, connect your agent to the Nayax MCP server as well.

Available skills

Prerequisites

Install skills

What you can do with a skill

Pair skills with the MCP server

Next steps

Inventory Workflow

Security & Token

​Available skills

​Prerequisites

​Install skills

​What you can do with a skill

​Pair skills with the MCP server

​Next steps

Inventory Workflow

Security & Token

Available skills

Prerequisites

Install skills

What you can do with a skill

Pair skills with the MCP server

Next steps