# EPS for AI agents

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

## Context packs
| 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
```

## 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.

## Claude Code plugin

One install wires the `eps` MCP, the `integrate-eps`, `sign-request` and `run-a-recipe` skills, and the `/eps` slash command into Claude Code:

```bash
/plugin marketplace add ekoindia/eps-platform
/plugin install eps@ekoindia
```

## Install matrix
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 -- npx -y @ekoindia/eps-context-mcp` | [CLAUDE.md](https://eps.eko.in/agent/CLAUDE.md) | `./CLAUDE.md` |
| Cursor | `.cursor/mcp.json` | [.cursorrules](https://eps.eko.in/agent/.cursorrules) | `./.cursorrules` |
| Codex | `codex mcp add eps npx -y @ekoindia/eps-context-mcp` | [AGENTS.md](https://eps.eko.in/agent/AGENTS.md) | `./AGENTS.md` |
| 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"]}'` | [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 — Send Money** — Full domestic money transfer flow: look up the sender, onboard them if new, add the recipient, then send an OTP-verified transfer.
- **AePS — Cash Withdrawal** — Aadhaar-enabled cash withdrawal: one-time agent activation, daily 2FA, then the biometric withdrawal.
