# Zain Ahmed Developer Portal

Integrate with Zain Ahmed's public engineering knowledge base using REST, MCP, or an official client. Public reads require no credentials. Production agent token issuance is unavailable; see [access and authentication status](https://zainahmed.net/auth.md).

## REST API

- [API entry point](https://zainahmed.net/api/v1): discover endpoints and client packages.
- [OpenAPI JSON](https://zainahmed.net/openapi.json) and [YAML](https://zainahmed.net/openapi.yaml): inspect operation IDs, inputs, and responses.
- [Documentation](https://zainahmed.net/docs): integration guides and access contracts.
- [Sandbox](https://zainahmed.net/sandbox): test contact payloads without sending email.

## Official clients

The [SDKs and CLI guide](https://zainahmed.net/docs/sdk) covers the official clients and safe integration examples. The [npm package @zainahmed.net/sdk](https://www.npmjs.com/package/@zainahmed.net/sdk) includes the TypeScript client and the `zainahmed` CLI. Inspect the public API with `npx @zainahmed.net/sdk status`, or install the client with `npm install @zainahmed.net/sdk`.

The [Python package zainahmed-sdk](https://pypi.org/project/zainahmed-sdk/) is available with `pip install zainahmed-sdk`.

The [Go SDK](https://pkg.go.dev/github.com/thezaynahmed/zainahmed-go) is available with `go get github.com/thezaynahmed/zainahmed-go@v0.1.0`.

## MCP servers

- [Operations endpoint](https://zainahmed.net/mcp) and [operations server card](https://zainahmed.net/.well-known/mcp/server-card.json).
- [Documentation endpoint](https://zainahmed.net/mcp/docs) and [documentation server card](https://zainahmed.net/.well-known/mcp/docs-server-card.json).
- [Server catalog](https://zainahmed.net/.well-known/mcp.json): discover both servers. Call `tools/list` for current input and output schemas.

## Agent skills and rules

Install the [official public skills](https://github.com/thezaynahmed/zainahmed-agent-skills) with `npx skills add thezaynahmed/zainahmed-agent-skills`. Read [agent instructions](https://zainahmed.net/agents.md) and [llms.txt](https://zainahmed.net/llms.txt) for additional entry points.

## Contact delivery

Configured production submissions use persistent idempotency and shared client/global quotas. Respect `RateLimit`, `RateLimit-Policy`, and `Retry-After`; reuse the same idempotency key and payload on retries. Provider acceptance is not inbox delivery. If delivery is unavailable, use the sandbox or email hello@zainahmed.net.