@mogintel/mcp-easypaisa

Community MCP wrapper for the mcp-easypaisa provider APIs. Not affiliated with the provider; wraps public interfaces only.

Install

npm install @mogintel/mcp-easypaisa

Related MCP server: @mogintel/mcp-jazzcash

Quick start

// 15-line stdio demo — populated by Epic 4/5/6/7.
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const transport = new StdioClientTransport({
  command: 'node',
  args: ['./node_modules/@mogintel/mcp-easypaisa/dist/index.js'],
});
const client = new Client({ name: 'nokar-facade', version: '0.0.0' }, { capabilities: {} });
await client.connect(transport);
// Story 1.2+ populates tools; at scaffold time `ping` is the only surface.
const pong = await client.callTool({ name: 'ping', arguments: {} });
console.log(pong);
await client.close();

Tool surface

(Story 1.1 scaffold; tools land in Epics 4–7.)

Auth setup

Credentials load from the Doppler scope nokar-prod-mcp-easypaisa. See each provider's onboarding runbook once Story 1.2+ ships src/auth.ts.

Error semantics

Errors re-export from @mogintel/mcp-pk-shared/errors once Story 1.2 lands the trust root. Every error carries a stable code, a retryable flag, and a redactedMessage field for observability hops.

Tier model

Every tool declares one of T1_READ | T2_WRITE_CONFIRM | T3_HUMAN_ONLY in the manifest. The facade enforces the tier at call time — the MCP itself does not gate tiers. See ARCHITECTURE-SPINE §AD-3.

Rate limits

Provider-imposed; consult the provider's public docs. This wrapper does not rate-limit locally.

Sandbox vs prod toggle

Environment variable NOKAR_PROVIDER_ENV selects sandbox vs prod. Details land alongside the provider's first tool implementation.

CONTRIBUTING

Auth-critical paths (src/tier_registry.ts) require security-team + Yahya sign-off. See .github/CODEOWNERS.

Licence (MIT)

See LICENSE.

Commercial CTA

Unaffiliated community wrapper around public APIs. Commercial support and hosted operator console via MogIntel — hi@mogintel.com.