@ekoindia/eps-context-mcp 0.1.22 → 0.1.24

package/README.md

@@ -72,12 +72,21 @@ clients can see this programmatically.
 | `get_topic`           | `topic` (`auth` \| `errors` \| `pricing` \| `environments`)                  | One documentation topic.                                                                                                                           |
 | `get_recipe`          | `id`                                                                         | One multi-step recipe (steps + branches).                                                                                                          |
 | `get_signing_snippet` | `language` (`php` \| `java` \| `csharp` \| `javascript` \| `python` \| `go`) | Paste-ready **backend** code to compute the request `secret-key`.                                                                                  |
+| `list_sdks`           | —                                                                            | The backend SDKs that wrap every endpoint: language, package, install command, minimum runtime, docs URL. Compact — no members or examples. |
+| `get_sdk`             | `language` (`javascript` \| `python` \| `php` \| `go` \| `java`; the guide slug such as `nodejs` also works) | One SDK in full: install + requirements, client config options with units, every public class/method/type, file-upload values, the error and timeout contract, and a worked `call()` example. |
 | `debug_auth`          | `timestamp?`, `secret_key?`                                                  | Diagnose a `403`: returns a known-answer test vector to check your signing against, mechanical checks on a supplied timestamp/signature, and ranked causes. **Never takes an `access_key`.** |
 | `get_meta`            | —                                                                            | Bundle org/version, data source (`baked` or `remote`), this server's `packageVersion`, and `updateAvailable` (whether a newer npm release exists). |
 
 **Tiered usage:** start with `list_apis` / `search` (cheap, compact), then call
 `get_api` only for the endpoint(s) you actually need. Same pattern for
-`list_topics` → `get_topic` and `list_recipes` → `get_recipe`.
+`list_topics` → `get_topic`, `list_recipes` → `get_recipe` and
+`list_sdks` → `get_sdk`.
+
+**Reach for an SDK first.** When the target language has one, `get_sdk` gives
+you install, client construction and the call pattern with signing, param
+validation and the error contract already handled — do not hand-roll the HMAC
+`secret-key`. `get_signing_snippet` is for the languages with no SDK (it covers
+`csharp` too) and for debugging a `403`.
 
 **Errors are actionable:** an unknown `slug`/`id` returns an MCP error result
 (`isError: true`) with "did you mean" suggestions and a pointer to

package/data/eps.json

@@ -2,7 +2,7 @@
   "meta": {
     "org": "ekoindia",
     "apiVersion": "v3",
-    "bundleVersion": "e6084a34",
+    "bundleVersion": "4b18a8ba",
     "environments": [
       {
         "id": "sandbox",
@@ -18803,15 +18803,15 @@
           "name": "vehicle_number",
           "type": "string",
           "required": true,
-          "description": "Vehicle registration number to verify (e.g. HR26DA8398).",
-          "example": "HR26DA8398",
+          "description": "Vehicle registration number to verify (e.g. HJ01ME5678).",
+          "example": "HJ01ME5678",
           "in": "body"
         }
       ],
       "sampleRequest": {
         "initiator_id": "9962981729",
         "client_ref_id": "2026010100123456789",
-        "vehicle_number": "HR26DA8398"
+        "vehicle_number": "HJ01ME5678"
       },
       "responseFields": [
         {
@@ -18847,7 +18847,7 @@
               "name": "reference_id",
               "type": "string",
               "description": "Unique reference ID for this verification request returned by Eko.",
-              "example": "EKO-RC-9876543210-001"
+              "example": "34247643"
             },
             {
               "name": "status",
@@ -20364,23 +20364,14 @@
           "type": "string",
           "required": true,
           "description": "Unique Electoral Photo Identity Card (EPIC) number to verify.",
-          "example": "ABC1234567",
-          "in": "body"
-        },
-        {
-          "name": "name",
-          "type": "string",
-          "required": false,
-          "description": "Name of the Voter ID cardholder. Optional; can be used for cross-verification against returned name.",
-          "example": "Rajesh Kumar",
+          "example": "UAI4574761",
           "in": "body"
         }
       ],
       "sampleRequest": {
         "initiator_id": "9962981729",
         "client_ref_id": "2026010100123456789",
-        "epic_number": "ABC1234567",
-        "name": "Rajesh Kumar"
+        "epic_number": "UAI4574761"
       },
       "responseFields": [
         {
@@ -23556,5 +23547,613 @@
         }
       ]
     }
+  ],
+  "sdks": [
+    {
+      "lang": "javascript",
+      "slug": "nodejs",
+      "title": "Node.js SDK",
+      "summary": "Backend-only Node.js client for every EPS API, with HMAC signing, input validation and typed errors built in.",
+      "packageName": "@ekoindia/eps-sdk",
+      "installCommand": "npm i @ekoindia/eps-sdk",
+      "registry": "npm",
+      "registryUrl": "https://www.npmjs.com/package/@ekoindia/eps-sdk",
+      "minRuntime": "Node.js 18 or newer",
+      "dependencies": "None — standard library only (`node:crypto`, global `fetch`).",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-js",
+      "docsUrl": "https://eps.eko.in/docs/sdk/nodejs",
+      "config": [
+        {
+          "name": "developerKey",
+          "type": "string",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "accessKey",
+          "type": "string",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "initiatorId",
+          "type": "string",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "userCode",
+          "type": "string",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "timeoutMs",
+          "type": "number",
+          "required": false,
+          "units": "milliseconds, default 30_000",
+          "description": "Aborts a request that takes longer. Named for its unit — Python and PHP use seconds."
+        },
+        {
+          "name": "fetch",
+          "type": "typeof fetch",
+          "required": false,
+          "description": "Inject a custom fetch implementation (proxies, tests)."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "EpsClient",
+          "signature": "new EpsClient(options: EpsClientOptions)",
+          "description": "The client. Throws immediately if constructed where `window` exists — `accessKey` must never reach a browser."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "client.call<T = unknown>(slug: string, params?: Record<string, unknown>): Promise<T>",
+          "description": "Validates, signs and sends one endpoint call; resolves with the decoded envelope."
+        },
+        {
+          "kind": "function",
+          "name": "signSecretKey",
+          "signature": "signSecretKey(accessKey: string, timestamp: string): string",
+          "description": "The raw signing primitive, exported for debugging. `call()` applies it for you."
+        },
+        {
+          "kind": "constant",
+          "name": "MULTIPART_JSON_FIELD",
+          "signature": "MULTIPART_JSON_FIELD = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        },
+        {
+          "kind": "type",
+          "name": "EpsClientOptions",
+          "signature": "interface EpsClientOptions",
+          "description": "The constructor options above."
+        },
+        {
+          "kind": "type",
+          "name": "SdkEndpoint / SdkParam",
+          "signature": "interface SdkEndpoint, interface SdkParam",
+          "description": "Shape of one endpoint in the embedded surface (slug, method, path, params)."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "EpsHttpError",
+          "when": "Any non-2xx response.",
+          "fields": "`status`, `url`, `body` (decoded envelope or null), `raw`"
+        },
+        {
+          "name": "EpsError",
+          "when": "Unknown slug, missing required param, wrong param type, bad option, or a 2xx body that is not JSON. `EpsHttpError` extends it."
+        },
+        {
+          "name": "TimeoutError (DOMException)",
+          "when": "The request exceeded `timeoutMs`. Surfaced raw, as Node reports it."
+        }
+      ],
+      "fileValues": [
+        "A local file path (read from disk; the filename is the basename)",
+        "A `Blob` or `File` (a `File` keeps its own name)"
+      ],
+      "notes": [
+        "ESM only (`\"type\": \"module\"`). Use `import`, or `await import()` from CommonJS.",
+        "A per-call cancellation signal is not supported yet — `timeoutMs` is the only abort source."
+      ],
+      "example": "import { EpsClient } from \"@ekoindia/eps-sdk\";\n\nconst client = new EpsClient({\n  developerKey: process.env.EPS_DEVELOPER_KEY,\n  accessKey: process.env.EPS_ACCESS_KEY,\n  initiatorId: \"9962981729\",\n  environment: \"sandbox\",\n});\n\nconst result = await client.call(\"pan-lite\", {\n  \"pan_number\": \"ABCDE1234F\",\n  \"name\": \"Rajesh Kumar\",\n  \"dob\": \"1994-08-29\"\n});\nconsole.log(result);"
+    },
+    {
+      "lang": "python",
+      "slug": "python",
+      "title": "Python SDK",
+      "summary": "Backend-only Python client for every EPS API, dependency-free and typed, with HMAC signing built in.",
+      "packageName": "eps-sdk",
+      "installCommand": "pip install eps-sdk",
+      "registry": "PyPI",
+      "registryUrl": "https://pypi.org/project/eps-sdk/",
+      "minRuntime": "Python 3.9 or newer",
+      "dependencies": "None — standard library only (`urllib`, `hmac`, `hashlib`, `mimetypes`).",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-python",
+      "docsUrl": "https://eps.eko.in/docs/sdk/python",
+      "config": [
+        {
+          "name": "developer_key",
+          "type": "str",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "access_key",
+          "type": "str",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "initiator_id",
+          "type": "str",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "user_code",
+          "type": "str",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "timeout",
+          "type": "float",
+          "required": false,
+          "units": "seconds, default 30.0",
+          "description": "Whole-request budget passed through to `urlopen`."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "EpsClient",
+          "signature": "EpsClient(developer_key, access_key, environment, initiator_id=None, user_code=None, timeout=30.0)",
+          "description": "The client — a dataclass, so keyword arguments read well."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "client.call(slug: str, params: Mapping[str, Any] | None = None) -> Any",
+          "description": "Validates, signs and sends one endpoint call; returns the decoded envelope."
+        },
+        {
+          "kind": "method",
+          "name": "resolve_target",
+          "signature": "client.resolve_target(slug, params=None) -> Target",
+          "description": "The signed method/url/body/headers for a call, without sending it. Useful for debugging."
+        },
+        {
+          "kind": "method",
+          "name": "build_headers",
+          "signature": "client.build_headers(multipart: bool = False) -> dict[str, str]",
+          "description": "The four auth headers for a single request."
+        },
+        {
+          "kind": "function",
+          "name": "sign_secret_key",
+          "signature": "sign_secret_key(access_key: str, timestamp: str) -> str",
+          "description": "The raw signing primitive, exported for debugging."
+        },
+        {
+          "kind": "constant",
+          "name": "MULTIPART_JSON_FIELD",
+          "signature": "MULTIPART_JSON_FIELD = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        },
+        {
+          "kind": "type",
+          "name": "Target",
+          "signature": "@dataclass Target(method, url, body, headers, multipart)",
+          "description": "What `resolve_target` returns."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "EpsHttpError",
+          "when": "Any non-2xx response.",
+          "fields": "`.status`, `.url`, `.body` (decoded envelope or None), `.raw` (bytes)"
+        },
+        {
+          "name": "EpsError",
+          "when": "Unknown slug, missing required param, wrong param type, bad config, or a 2xx body that is not JSON. `EpsHttpError` subclasses it."
+        },
+        {
+          "name": "urllib.error.URLError",
+          "when": "Transport failure or timeout. Surfaced raw."
+        }
+      ],
+      "fileValues": [
+        "A path `str` or `os.PathLike` (the MIME type is guessed, falling back to `application/octet-stream`)",
+        "An in-memory `(filename, bytes)` tuple"
+      ],
+      "notes": [
+        "Paths are checked for existence during validation, so a typo fails before the request is signed."
+      ],
+      "example": "import os\n\nfrom eps_sdk import EpsClient\n\nclient = EpsClient(\n    developer_key=os.environ[\"EPS_DEVELOPER_KEY\"],\n    access_key=os.environ[\"EPS_ACCESS_KEY\"],\n    initiator_id=\"9962981729\",\n    environment=\"sandbox\",\n)\n\nresult = client.call(\"pan-lite\", {\n    \"pan_number\": \"ABCDE1234F\",\n    \"name\": \"Rajesh Kumar\",\n    \"dob\": \"1994-08-29\",\n})\nprint(result)"
+    },
+    {
+      "lang": "php",
+      "slug": "php",
+      "title": "PHP SDK",
+      "summary": "Backend-only PHP client for every EPS API, with HMAC signing, input validation and typed errors built in.",
+      "packageName": "ekoindia/eps-sdk",
+      "installCommand": "composer require ekoindia/eps-sdk",
+      "registry": "Packagist",
+      "registryUrl": "https://packagist.org/packages/ekoindia/eps-sdk",
+      "minRuntime": "PHP 8.1 or newer",
+      "dependencies": "None beyond the `curl` and `json` extensions.",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-php",
+      "docsUrl": "https://eps.eko.in/docs/sdk/php",
+      "installNotes": [
+        "Published from a read-only mirror (`ekoindia/eps-sdk-php`), subtree-split from the monorepo."
+      ],
+      "config": [
+        {
+          "name": "$developerKey",
+          "type": "string",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "$accessKey",
+          "type": "string",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "$environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "$initiatorId",
+          "type": "string",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "$userCode",
+          "type": "string",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "$timeout",
+          "type": "float",
+          "required": false,
+          "units": "seconds, default 30.0",
+          "description": "Whole-request budget, applied as `CURLOPT_TIMEOUT_MS` so sub-second values are not truncated."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "Eko\\Eps\\EpsClient",
+          "signature": "new EpsClient(string $developerKey, string $accessKey, string $environment, ?string $initiatorId = null, ?string $userCode = null, float $timeout = 30.0)",
+          "description": "The client. Use named arguments."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "$client->call(string $slug, array $params = []): array",
+          "description": "Validates, signs and sends one endpoint call; returns the decoded envelope."
+        },
+        {
+          "kind": "method",
+          "name": "resolveTarget",
+          "signature": "$client->resolveTarget(string $slug, array $params = []): array",
+          "description": "The signed url/body/method for a call, without sending it. Exposed for testing."
+        },
+        {
+          "kind": "method",
+          "name": "curlOptions",
+          "signature": "$client->curlOptions(array $target): array",
+          "description": "The cURL option map `call()` uses, including the timeout. Exposed for testing."
+        },
+        {
+          "kind": "method",
+          "name": "decodeResponse",
+          "signature": "EpsClient::decodeResponse(int $status, string $url, string $raw): array",
+          "description": "Static. Applies the shared response contract to one raw response — the seam the conformance tests drive."
+        },
+        {
+          "kind": "method",
+          "name": "signSecretKey",
+          "signature": "EpsClient::signSecretKey(string $accessKey, string $timestamp): string",
+          "description": "Static. The raw signing primitive, exposed for debugging."
+        },
+        {
+          "kind": "constant",
+          "name": "EpsClient::MULTIPART_JSON_FIELD",
+          "signature": "const MULTIPART_JSON_FIELD = 'form-data'",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "Eko\\Eps\\EpsHttpException",
+          "when": "Any non-2xx response.",
+          "fields": "`->status`, `->url`, `->body` (decoded envelope or null), `->raw`"
+        },
+        {
+          "name": "Eko\\Eps\\EpsException",
+          "when": "Transport failure, a malformed surface asset, or a 2xx body that is not JSON. Extends `\\RuntimeException`."
+        },
+        {
+          "name": "\\InvalidArgumentException",
+          "when": "Unknown environment or slug, missing required param, wrong param type. SPL already has the right class, and it is a `\\LogicException`, so it cannot share a base with the runtime failures."
+        }
+      ],
+      "fileValues": [
+        "A local file path (wrapped in a `CURLFile` for you)",
+        "A `\\CURLFile` you built yourself"
+      ],
+      "notes": [
+        "Presence is checked with `isset()`, so a param explicitly set to `null` counts as missing — matching every other SDK."
+      ],
+      "example": "<?php\nuse Eko\\Eps\\EpsClient;\n\n$client = new EpsClient(\n    developerKey: getenv('EPS_DEVELOPER_KEY'),\n    accessKey: getenv('EPS_ACCESS_KEY'),\n    initiatorId: '9962981729',\n    environment: 'sandbox'\n);\n\n$result = $client->call('pan-lite', [\n    'pan_number' => 'ABCDE1234F',\n    'name' => 'Rajesh Kumar',\n    'dob' => '1994-08-29'\n]);\nprint_r($result);"
+    },
+    {
+      "lang": "go",
+      "slug": "go",
+      "title": "Go SDK",
+      "summary": "Backend-only Go client for every EPS API — standard library only, context-aware, with HMAC signing built in.",
+      "packageName": "github.com/ekoindia/eps-sdk-go",
+      "installCommand": "go get github.com/ekoindia/eps-sdk-go",
+      "registry": "Go modules",
+      "registryUrl": "https://pkg.go.dev/github.com/ekoindia/eps-sdk-go",
+      "minRuntime": "Go 1.22 or newer",
+      "dependencies": "None — `go.mod` has no `require` block and there is no `go.sum`.",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-go",
+      "docsUrl": "https://eps.eko.in/docs/sdk/go",
+      "installNotes": [
+        "Published from a read-only mirror (`ekoindia/eps-sdk-go`) as a git tag; there is no separate registry."
+      ],
+      "config": [
+        {
+          "name": "DeveloperKey",
+          "type": "string",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "AccessKey",
+          "type": "string",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "Environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "InitiatorID",
+          "type": "string",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "UserCode",
+          "type": "string",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "HTTPClient",
+          "type": "*http.Client",
+          "required": false,
+          "units": "default: 30s timeout",
+          "description": "Control timeouts, proxies or retries by supplying your own client."
+        }
+      ],
+      "members": [
+        {
+          "kind": "function",
+          "name": "eps.New",
+          "signature": "eps.New(cfg eps.Config) (*eps.Client, error)",
+          "description": "Builds a client. Safe for concurrent use once constructed."
+        },
+        {
+          "kind": "method",
+          "name": "Call",
+          "signature": "client.Call(ctx context.Context, slug string, params map[string]any) (map[string]any, error)",
+          "description": "Validates, signs and sends one endpoint call. The only SDK with per-call cancellation."
+        },
+        {
+          "kind": "method",
+          "name": "ResolveTarget",
+          "signature": "client.ResolveTarget(slug string, params map[string]any) (*eps.Target, error)",
+          "description": "The signed request for a call, without sending it."
+        },
+        {
+          "kind": "method",
+          "name": "BuildHeaders",
+          "signature": "client.BuildHeaders(multipartBody bool) map[string]string",
+          "description": "The four auth headers for a single request."
+        },
+        {
+          "kind": "function",
+          "name": "eps.Sign",
+          "signature": "eps.Sign(accessKey, timestamp string) string",
+          "description": "The raw signing primitive, exported for debugging."
+        },
+        {
+          "kind": "type",
+          "name": "eps.File",
+          "signature": "eps.File{Name string; Content []byte}",
+          "description": "An in-memory upload."
+        },
+        {
+          "kind": "constant",
+          "name": "eps.MultipartJSONField",
+          "signature": "MultipartJSONField = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "*eps.HTTPError",
+          "when": "Any non-2xx response. Match it with `errors.As`.",
+          "fields": "`StatusCode`, `URL`, `Body` (decoded envelope or nil), `Raw`"
+        },
+        {
+          "name": "error",
+          "when": "Unknown slug, missing required param, wrong param type, a 2xx body that is not JSON, or a transport failure. Messages are lowercase and `eps:`-prefixed, per Go convention."
+        }
+      ],
+      "fileValues": [
+        "A local file path `string`",
+        "An `eps.File{Name, Content}` (or `*eps.File`) for an in-memory upload"
+      ],
+      "notes": [
+        "Map keys are sorted before encoding, so query strings and multipart bodies are byte-deterministic.",
+        "The surface is embedded with `go:embed`, so the package needs no network call to resolve a slug."
+      ],
+      "example": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\t\"os\"\n\n\teps \"github.com/ekoindia/eps-sdk-go\"\n)\n\nfunc main() {\n\tclient, err := eps.New(eps.Config{\n\t\tDeveloperKey: os.Getenv(\"EPS_DEVELOPER_KEY\"),\n\t\tAccessKey:    os.Getenv(\"EPS_ACCESS_KEY\"),\n\t\tInitiatorID:  \"9962981729\",\n\t\tEnvironment:  \"sandbox\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tresult, err := client.Call(context.Background(), \"pan-lite\", map[string]any{\n\t\t\"pan_number\": \"ABCDE1234F\",\n\t\t\"name\":       \"Rajesh Kumar\",\n\t\t\"dob\":        \"1994-08-29\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Println(result)\n}"
+    },
+    {
+      "lang": "java",
+      "slug": "java",
+      "title": "Java SDK",
+      "summary": "Backend-only Java client for every EPS API, published from a git tag via JitPack, with HMAC signing built in.",
+      "packageName": "com.github.ekoindia:eps-sdk-java",
+      "installCommand": "com.github.ekoindia:eps-sdk-java",
+      "registry": "JitPack",
+      "registryUrl": "https://jitpack.io/#ekoindia/eps-sdk-java",
+      "minRuntime": "Java 17 or newer",
+      "dependencies": "One: Gson, because Java has no JSON parser in the standard library. HTTP uses the JDK's own `java.net.http`.",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-java",
+      "docsUrl": "https://eps.eko.in/docs/sdk/java",
+      "installNotes": [
+        "Published through JitPack from a git tag — add the JitPack repository alongside Maven Central.",
+        "Gradle: `maven { url 'https://jitpack.io' }`, then `implementation 'com.github.ekoindia:eps-sdk-java:<tag>'`.",
+        "Maven: a `<repository>` with id `jitpack.io` and url `https://jitpack.io`, then the `com.github.ekoindia:eps-sdk-java` dependency."
+      ],
+      "config": [
+        {
+          "name": ".developerKey(…)",
+          "type": "String",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": ".accessKey(…)",
+          "type": "String",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": ".environment(…)",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": ".initiatorId(…)",
+          "type": "String",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": ".userCode(…)",
+          "type": "String",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": ".httpClient(…)",
+          "type": "HttpClient",
+          "required": false,
+          "units": "default: 30s connect + 30s per request",
+          "description": "Control timeouts, proxies or redirects by supplying your own client."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "in.eko.eps.EpsClient",
+          "signature": "EpsClient.builder()…build()",
+          "description": "The client, built through a fluent builder."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "client.call(String slug, Map<String, Object> params): Map<String, Object>",
+          "description": "Validates, signs and sends one endpoint call; returns the decoded envelope."
+        },
+        {
+          "kind": "method",
+          "name": "resolveTarget",
+          "signature": "client.resolveTarget(String slug, Map<String, Object> params): Target",
+          "description": "The signed request for a call, without sending it."
+        },
+        {
+          "kind": "method",
+          "name": "buildHeaders",
+          "signature": "client.buildHeaders(boolean multipart): Map<String, String>",
+          "description": "The four auth headers for a single request."
+        },
+        {
+          "kind": "method",
+          "name": "sign",
+          "signature": "EpsClient.sign(String accessKey, String timestamp): String",
+          "description": "Static. The raw signing primitive, exposed for debugging."
+        },
+        {
+          "kind": "type",
+          "name": "EpsClient.EpsFile",
+          "signature": "record EpsFile(String name, byte[] content)",
+          "description": "An in-memory upload."
+        },
+        {
+          "kind": "constant",
+          "name": "EpsClient.MULTIPART_JSON_FIELD",
+          "signature": "MULTIPART_JSON_FIELD = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "EpsClient.EpsHttpException",
+          "when": "Any non-2xx response.",
+          "fields": "`status`, `url`, `body` (decoded envelope or null), `raw`"
+        },
+        {
+          "name": "EpsClient.EpsException",
+          "when": "Unknown slug, missing required param, wrong param type, transport failure, or a 2xx body that is not JSON. Unchecked — it extends `RuntimeException`."
+        }
+      ],
+      "fileValues": [
+        "A `String` path, a `java.nio.file.Path`, or a `java.io.File`",
+        "An `EpsClient.EpsFile(name, content)` for an in-memory upload"
+      ],
+      "notes": [
+        "Upload parts are sent as `application/octet-stream`; the MIME type is not sniffed.",
+        "Gson is configured with `serializeNulls()` — required for wire conformance, since every other SDK keeps explicit nulls."
+      ],
+      "example": "import in.eko.eps.EpsClient;\nimport java.util.Map;\n\nEpsClient client = EpsClient.builder()\n    .developerKey(System.getenv(\"EPS_DEVELOPER_KEY\"))\n    .accessKey(System.getenv(\"EPS_ACCESS_KEY\"))\n    .initiatorId(\"9962981729\")\n    .environment(\"sandbox\")\n    .build();\n\nMap<String, Object> result = client.call(\"pan-lite\", Map.of(\n        \"pan_number\", \"ABCDE1234F\",\n        \"name\", \"Rajesh Kumar\",\n        \"dob\", \"1994-08-29\"\n    ));\nSystem.out.println(result);"
+    }
   ]
 }

package/dist/index.js

@@ -66,6 +66,19 @@ var searchApis = (bundle, query, limit) => {
 var getApi = (bundle, slug) => bundle.apis.find((a) => a.slug === slug);
 var getTopic = (bundle, topic) => bundle.topics[topic];
 var getRecipe = (bundle, id) => bundle.recipes.find((r) => r.id === id);
+var listSdks = (bundle) => (bundle.sdks ?? []).map((s) => ({
+  lang: s.lang,
+  slug: s.slug,
+  title: s.title,
+  packageName: s.packageName,
+  installCommand: s.installCommand,
+  registry: s.registry,
+  minRuntime: s.minRuntime,
+  docsUrl: s.docsUrl
+}));
+var listSdkLanguages = (bundle) => (bundle.sdks ?? []).map((s) => s.lang);
+var listSdkSlugs = (bundle) => (bundle.sdks ?? []).map((s) => s.slug);
+var getSdk = (bundle, language) => (bundle.sdks ?? []).find((s) => s.lang === language || s.slug === language);
 
 // src/auth-debug.ts
 var MS_DIGITS = 13;
@@ -322,6 +335,9 @@ var createEpsServer = (bundle, source, versionState) => {
   const categories = listCategories(bundle);
   const categorySchema = categories.length ? z.enum(categories) : z.string();
   const limitSchema = z.number().int().positive().optional();
+  const sdkLanguages = listSdkLanguages(bundle);
+  const sdkAliases = [.../* @__PURE__ */ new Set([...sdkLanguages, ...listSdkSlugs(bundle)])];
+  const sdkLanguageSchema = sdkAliases.length ? z.enum(sdkAliases) : z.string();
   server.registerTool(
     "list_apis",
     {
@@ -436,6 +452,35 @@ var createEpsServer = (bundle, source, versionState) => {
       content: [{ type: "text", text: getSigningSnippet(language) }]
     })
   );
+  server.registerTool(
+    "list_sdks",
+    {
+      title: "List EPS SDKs",
+      description: "The backend SDKs that wrap every EPS endpoint (language, package, install command, minimum runtime, docs URL). Prefer an SDK over hand-written HTTP: signing, param validation and the error contract are built in. Call get_sdk for the full surface of one.",
+      inputSchema: {},
+      annotations: READ_ONLY
+    },
+    async () => json(listSdks(bundle))
+  );
+  server.registerTool(
+    "get_sdk",
+    {
+      title: "Get an EPS SDK",
+      description: "Everything needed to integrate with one EPS SDK: install command and requirements, client config options with their units, every public class/method/type, file-upload values, the error and timeout contract, and a worked call() example. Signing is built in \u2014 NEVER hand-roll the HMAC secret-key when an SDK exists for the language.",
+      inputSchema: {
+        language: sdkLanguageSchema.describe(
+          `One of: ${sdkLanguages.join(", ")} (the guide slug, e.g. "nodejs", also works)`
+        )
+      },
+      annotations: READ_ONLY
+    },
+    async ({ language }) => {
+      const sdk = getSdk(bundle, language);
+      return sdk ? json(sdk) : notFound(
+        `No EPS SDK for "${language}". Available: ${sdkLanguages.join(", ")}. For other languages call the REST API directly and use get_signing_snippet.`
+      );
+    }
+  );
   server.registerTool(
     "debug_auth",
     {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ekoindia/eps-context-mcp",
-	"version": "0.1.22",
+	"version": "0.1.24",
 	"description": "Local MCP server giving AI coding agents context for Eko Platform Services (EPS) APIs.",
 	"license": "MIT",
 	"type": "module",