eSIM Access API Agent Skill

Introducing the esimaccess-api Skill: Manage eSIMs from Any AI Chat

We built the esimaccess-api skill so that eSIM Access partners can manage the full API lifecycle
— orders, top-ups, usage, status checks, cancellations, webhooks — directly from their AI coding assistant. No dashboard switching, no curl commands, no
reading docs. Just tell your AI what you need.

What is an AI agent skill?

A skill is a structured knowledge file that teaches an AI assistant how to use a specific API. When you install the esimaccess-api skill, your AI learns
the eSIM Access API’s endpoints, authentication, data formats, status states, and business rules. It can then make real API calls on your behalf —
checking balances, ordering eSIMs, querying usage, and more — all through natural language.

The skill works with 40+ AI coding agents including Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, Cline, and Roo.

Install in one command

npx skills add esimaccess/esimaccess-api

That’s it. The skill is pulled from GitHub and added to your agent’s skill directory. You’ll
need your accessCode from the eSIM Access Developer Console.

What can you do with it?

The skill covers 17 operations across the entire eSIM lifecycle:

Read operations (safe, no cost):

• Check your account balance
• List available packages by country or region
• Check order status and get ICCIDs
• Query eSIM profile details — install state, usage, expiry
• View data consumption stats
• Query webhook configuration

Write operations (costs money or modifies state):

• Create new eSIM orders
• Apply data top-ups to existing eSIMs
• Cancel unused eSIMs (with refund)
• Suspend, unsuspend, or revoke eSIM profiles
• Send SMS to eSIM numbers
• Configure webhooks for status notifications

Composite workflows:

• Refund and reissue — cancel an unused eSIM, verify the refund, and order a replacement with the same package in one step

Example prompts

Once installed, you just talk to your AI naturally:

• “Check my eSIM Access balance”
• “What packages are available for Japan?”
• “Order a 5GB plan for the US”
• “How much data has ICCID 89852240810733629810 used?”
• “Top up my eSIM with another 5GB”
• “Cancel this unused eSIM and get a refund”
• “Set up a webhook for order notifications”

The AI handles authentication (HMAC-SHA256 signing), data format conversion (prices are in ten-thousandths of USD, volumes in bytes), and knows the
business rules — like when to use esimTranNo vs ICCID, or the difference between cancel (refund) and revoke (no refund).

What’s included

The skill ships with three files:

• SKILL.md — The skill definition with all 17 operations, trigger keywords, quick reference, and business rules
• references/api-reference.md — Complete API documentation including endpoints, authentication examples in Node.js and Python, eSIM
  status state machine, webhook types, and error codes
• scripts/test-esim-api.mjs — A 15-test end-to-end test suite you can run to verify your credentials and API access

Who is this for?

eSIM resellers managing inventory — check balance, list packages by country, create orders, and monitor provisioning status without
leaving your editor.

Support teams troubleshooting customer issues — look up eSIM status by ICCID, check data usage, cancel unused eSIMs with automatic
refund verification.

Developers integrating the API — use the skill as a living reference for authentication, endpoint formats, status states, webhooks, and
error codes. Ask your AI to generate integration code in any language.

Get started

1. Get your access code from the Developer Console
2. Install: npx skills add esimaccess/esimaccess-api
3. Verify: tell your AI “Check my eSIM Access balance”

View the full skill documentation and source on GitHub, or visit the skill landing page.