---
title: Yari Infotech API Docs, MCP Server, CLI & Developer Sandbox
description: Official Yari Infotech REST API v1 documentation, OpenAPI 3.1 specification, live MCP server, npm CLI package (yariinfotech-mcp), and verified zero-auth developer sandbox.
canonical: https://yariinfotech.com/developers
last-updated: 2026-11-19
---

# Yari Infotech Developer Portal, API Docs & Agent Sandbox

> API v1.0 | MCP 2025-03-26 | A2A v1.0.0 | NLWeb /ask | Canonical URL: https://yariinfotech.com/developers

## Verified Sandbox Surface & Test Environment
- Interactive Sandbox Playground: https://yariinfotech.com/sandbox
- Live Zero-Auth Sandbox Status Endpoint: https://yariinfotech.com/api/v1/sandbox
- Sandboxed Services API: https://yariinfotech.com/api/v1/sandbox/services
- Sandboxed Projects API: https://yariinfotech.com/api/v1/sandbox/projects
- Sandboxed Async Audit Simulation: https://yariinfotech.com/api/v1/sandbox/audits (POST)
- Rate Limit Policy in Sandbox: 120 req/min per IP, zero credentials required (`X-Sandbox: true`).

## Model Context Protocol (MCP) Server & CLI Package
- Official npm CLI & SDK Package: https://www.npmjs.com/package/yariinfotech-mcp (`npx yariinfotech-mcp`)
- MCP Server Registry ID: com.yariinfotech/server
- Hosted Streamable-HTTP MCP Endpoint: https://yariinfotech.com/mcp
- Read-only Tools: `get_services` (inspect capabilities), `get_case_studies` (verified outcomes), `estimate_project` (scope calculator).
- Local CLI command: `npx yariinfotech-mcp services` or `npm install -g yariinfotech-mcp`

## Production REST v1 API Endpoints
- `GET /api/v1/services`: Paginated catalog of 12 engineering services (`?pillar=`, `?limit=`, `?cursor=`).
- `GET /api/v1/projects`: Paginated public case studies and measured engineering metrics.
- `POST /api/v1/audits`: Queue an asynchronous readiness audit job (`202 Accepted`, supports `Idempotency-Key`).
- `GET /api/v1/jobs/{jobId}`: Poll asynchronous job status and results.
- `POST /mcp`: Streamable HTTP Model Context Protocol server.
- `POST /api/a2a`: A2A v1.0.0 JSON-RPC 2.0 endpoint.
- `POST /ask`: NLWeb query endpoint with JSON and SSE streaming.

## API Versioning & Deprecation Policy
- Stable endpoints are URL-versioned under `/api/v1/` with `X-API-Version: 1.0.0`.
- Deprecated routes (including legacy `/api/services`) carry a minimum 12-month notice window and emit RFC 9745 `Deprecation: true`, RFC 8594 `Sunset: Fri, 31 Dec 2027 23:59:59 GMT`, and `Link: rel="successor-version"` headers.

## Machine Discovery Manifests & Specifications
- OpenAPI 3.1 Specification: https://yariinfotech.com/openapi.json
- RFC 9727 API Catalog: https://yariinfotech.com/.well-known/api-catalog
- MCP Server Card: https://yariinfotech.com/.well-known/mcp/server-card.json
- A2A Agent Card: https://yariinfotech.com/.well-known/agent-card.json
- ARD Catalog: https://yariinfotech.com/.well-known/ard.json
- Agent Skills Index: https://yariinfotech.com/.well-known/agent-skills/index.json
- Agent Skills Directory: https://skills.sh/yari-infotech/yari-skills (Install: `npx skills add yari-infotech/yari-skills`)
- Agent Skills GitHub: https://github.com/yari-infotech/yari-skills
