# @mogintel/mcp-jazzcash

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

## Install

```
npm install @mogintel/mcp-jazzcash
```

## Quick start

```ts
// 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-jazzcash/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.)*

| Tool | Tier | Description |
| --- | --- | --- |
| _(none — populated in downstream epic)_ | — | — |

## Auth setup

Credentials load from the Doppler scope `nokar-prod-mcp-jazzcash`. 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](./LICENSE).

## Commercial CTA

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