# EPS for AI agents

Everything an AI coding agent needs to integrate Eko Platform Services, auto-generated from our API source of truth.

## Quick start — how to build with AI

1. **Get an AI coding agent** — Claude Code, Cursor, Codex, GitHub Copilot, or any MCP-compatible tool.
2. **Add EPS to your agent (one-time)** — Claude Code and Codex install the EPS plugin; other tools wire the MCP server or a context pack. Exact steps below.
3. **Ask in plain English** — sample prompts:
   - **Find the right API:** "Which EPS API should I use to verify a customer's bank account?"
   - **Integrate an API:** "Integrate EPS PAN verification into my app, end to end, and test it in the sandbox."
   - **Fix a bug:** "My EPS money transfer call fails with error 403. Find the cause and fix it."

## Plugin install (Claude Code & Codex)

Two-step native plugin install — add the marketplace, then install the `eps` plugin (skills + `/eps` command; wires the MCP automatically on Claude Code). Other agents: see the manual install matrix below.

**Claude Code**

```bash
/plugin marketplace add ekoindia/eps-platform
/plugin install eps@ekoindia
```
> Run both inside the Claude Code prompt. Installs the skills and the /eps command, and wires the eps MCP automatically. The manual MCP command below is only needed if you skip the plugin.

**Codex**

```bash
codex plugin marketplace add ekoindia/eps-platform
codex plugin add eps@ekoindia
```
> Installs the eps skills. Codex does not yet auto-launch the plugin's bundled MCP server, so also run the MCP install command below to get the eps tools.

## Context packs (fallback)
Append-able EPS sections for agents without MCP or skills support — add to your existing instruction file, don't replace it:
| Target | File |
| --- | --- |
| Any agent (AGENTS.md) | https://eps.eko.in/agent/AGENTS.md |
| Claude Code (CLAUDE.md) | https://eps.eko.in/agent/CLAUDE.md |
| Cursor (.cursorrules) | https://eps.eko.in/agent/.cursorrules |
| GitHub Copilot | https://eps.eko.in/agent/copilot-instructions.md |

## Local MCP server

```bash
npx -y @ekoindia/eps-context-mcp@latest
```

## Offline mock server

Pairs with the MCP for offline testing — the mock server replays golden sample responses (with recipe-aware error branching) so agents develop and test without ever touching the live API:

```bash
npx -y @ekoindia/eps-mock-server
```

It mirrors the real EPS paths — point your EPS base URL at `http://localhost:4010`, then append `?eps_scenario=<response_status_id>` to force a documented error branch.

## Manual install matrix (other agents)
EPS rides on open standards (MCP + `AGENTS.md`-style context packs), so it works in any modern coding agent. Wire it into each harness:
| Harness | MCP install | Pack file | Placement |
| --- | --- | --- | --- |
| Claude Code | `claude mcp add eps --scope project -- npx -y @ekoindia/eps-context-mcp@latest` | [CLAUDE.md](https://eps.eko.in/agent/CLAUDE.md) | `./CLAUDE.md` |
| Codex | `codex mcp add eps npx -y @ekoindia/eps-context-mcp@latest` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | `./AGENTS.md` |
| Cursor | `.cursor/mcp.json` | [.cursorrules](https://eps.eko.in/agent/.cursorrules) | `./.cursorrules` |
| Antigravity | `~/.gemini/config/mcp_config.json` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | `./GEMINI.md` |
| GitHub Copilot | `code --add-mcp '{"name":"eps","command":"npx","args":["-y","@ekoindia/eps-context-mcp@latest"]}'` | [copilot-instructions.md](https://eps.eko.in/agent/copilot-instructions.md) | `./.github/copilot-instructions.md` |
| OpenCode | `opencode.json` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | `./AGENTS.md` |
| Kiro | `.kiro/settings/mcp.json` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | `.kiro/steering/eps.md` |
| Zed | `Zed settings.json` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | — |
| Aider | — | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | `CONVENTIONS.md` |
| JetBrains AI | `MCP config` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | — |
| Others | `MCP config` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | — |

## Machine bundle
- Canonical: https://eps.eko.in/agent/eps.json
- Index: https://eps.eko.in/agent/index.json
- Per-API: https://eps.eko.in/agent/api/<slug>.json
- OpenAPI: https://eps.eko.in/openapi.json

## SDKs & tools
| Tool | Link |
| --- | --- |
| @ekoindia/eps-sdk (npm — Node.js) | https://www.npmjs.com/package/@ekoindia/eps-sdk |
| ekoindia/eps-sdk (Composer — PHP) | https://packagist.org/packages/ekoindia/eps-sdk |
| Postman collection | https://eps.eko.in/agent/eps.postman_collection.json |
Backend-only signed SDKs (HMAC baked in); keep `access_key` server-side only.

## Recipes
- **[DMT (Fino) — Send Money](https://eps.eko.in/recipe/dmt-fino-send-money.md)** — Full Fino DMT money-transfer flow: look up the sender, onboard them if new, add the recipient, then send an OTP-verified transfer.
- **[AePS (Fingpay) — Cash Withdrawal](https://eps.eko.in/recipe/aeps-fingpay-cash-withdrawal.md)** — Aadhaar-enabled cash withdrawal: one-time agent activation and eKYC, daily KYC, then the biometric withdrawal.