# Erayaha AI

> Deterministic structured reasoning compiler and automated contract vulnerability scanner for high-stakes enterprise agreements.

Erayaha compiles natural language contracts, SOWs, SLAs, and policies into directed acyclic logic graphs to detect circular obligations, indemnification loops, and missing liability caps directly inside MS Word and Google Docs or programmatically via REST API and MCP.

## When to Use Erayaha AI

Reach for Erayaha when you need:
- **Autonomous Contract Redlining**: Auditing NDAs, MSAs, DPAs, vendor agreements, and commercial leases for high-risk clause liabilities.
- **Dependency & Loop Detection**: Detecting conflicting dates, circular performance triggers, and cross-document dependency risks that sequential language models overlook.
- **Playbook Compliance Verification**: Validating inbound contracts against corporate fallback playbooks and generating mathematically tested inline redlines.
- **High-Volume Contract Audits**: Batch scanning contract repositories during M&A due diligence, vendor renewal cycles, or SOC 2 / GDPR compliance reviews.
- **Legal Operations ROI Modeling**: Estimating annual savings and legal hour reductions for corporate legal teams.

## How Agents Should Call Erayaha

AI agents can interact with Erayaha through two machine-readable interfaces:

### 1. REST API
- Base URL: `https://erayaha.ai/api/v1`
- OpenAPI 3.1.0 Specification: [OpenAPI JSON](https://erayaha.ai/openapi.json) | [OpenAPI YAML](https://erayaha.ai/openapi.yaml)
- Key Endpoints:
  - `POST /api/v1/scan`: Scan contract text for structural risks and clause liabilities (`operationId: scanContractVulnerability`). Supports `Idempotency-Key` header.
  - `POST /api/v1/playbook/analyze`: Compare clause against standard fallback playbook (`operationId: analyzeClausePlaybook`). Supports `Idempotency-Key` header.
  - `POST /api/v1/roi/calculate`: Compute legal operations savings and payback timeline (`operationId: calculateRoiSavings`).
  - `POST /api/v1/contracts/batch-scan`: Bulk scan multiple contracts simultaneously (`operationId: batchScanContracts`). Supports `Idempotency-Key` header.
  - `GET /api/v1/health`: Verify API and reasoning engine health (`operationId: getHealthStatus`).
- Errors: All error responses use RFC 9457 `application/problem+json` with stable `code`, `title`, `detail`, and `hint` fields.
- Rate Limits: Standard IETF `RateLimit-*` headers returned on every API response (120 req/min limit).

### 2. Model Context Protocol (MCP) Server
- Endpoint: `https://erayaha.ai/mcp` (Streamable HTTP Transport)
- Server Card: [MCP Server Card](https://erayaha.ai/.well-known/mcp/server-card.json)
- Tools:
  - `scanContractVulnerability`: Read-only contract risk scanner returning vulnerability cards.
  - `analyzeClausePlaybook`: Clause compliance verification against playbook fallbacks.
  - `calculateRoiSavings`: Operational savings and efficiency calculations.
  - `batchScanContracts`: High-throughput contract batch scanning.
- Resources:
  - `erayaha://playbooks/standard-nda`: Enterprise Mutual NDA fallback rules.
  - `erayaha://benchmarks/clause-risk-index`: Risk scoring weights and vulnerability index.
  - `erayaha://rules/compliance-catalog`: SOC 2, HIPAA, and GDPR clause compliance criteria.
  - `erayaha://legal/dpa-standard`: Erayaha DPA standard v2.1 terms and schedules.

## Developer & Machine-Readable Resources

- [API Documentation](https://erayaha.ai/docs): Complete REST and MCP developer documentation.
- [Developer Portal](https://erayaha.ai/developers): Integration guides, curl examples, and SDK instructions.
- [API Versioning Policy](https://erayaha.ai/versioning): Versioning strategy, deprecation lifecycle, and Sunset headers.
- [Instant Sandbox API Keys](https://erayaha.ai/api/v1/sandbox/keys): Free instant self-serve API key provisioning for AI agents (`POST /api/v1/sandbox/keys`).
- [OpenAPI Specification (JSON)](https://erayaha.ai/openapi.json): Full OpenAPI 3.1.0 JSON schema.
- [OpenAPI Specification (YAML)](https://erayaha.ai/openapi.yaml): Full OpenAPI 3.1.0 YAML schema.
- [OAuth 2.0 Authorization Server](https://erayaha.ai/.well-known/oauth-authorization-server): RFC 8414 authorization server metadata.
- [OAuth 2.0 Protected Resource](https://erayaha.ai/.well-known/oauth-protected-resource): RFC 9728 protected resource metadata.
- [MCP Manifest](https://erayaha.ai/.well-known/mcp.json): Standard Model Context Protocol manifest.
- [Pricing Specification (Markdown)](https://erayaha.ai/pricing.md): Machine-readable pricing statement.
- [Pricing Page](https://erayaha.ai/pricing): Free Trial, Individual Pro, Team, and Enterprise commercial subscription tiers.
- [MCP Server Card](https://erayaha.ai/.well-known/mcp/server-card.json): MCP server discovery card.
- [AI Catalog](https://erayaha.ai/.well-known/ai-catalog.json): RFC 9727 AI catalog registration.
- [API Catalog](https://erayaha.ai/.well-known/api-catalog): RFC 9727 API catalog endpoint.
- [Agent Skills Index](https://erayaha.ai/.well-known/agent-skills/index.json): Agentskills.io v0.2.0 index.
- [Full LLM Index](https://erayaha.ai/llms-full.txt): Comprehensive deep-dive index for LLMs.
- [XML Sitemap](https://erayaha.ai/sitemap.xml): Search engine and crawler index.

## Trust, Compliance & Legal

- [About Erayaha](https://erayaha.ai/about): Company mission, leadership, and structured reasoning architecture.
- [Contact & Support](https://erayaha.ai/contact): Corporate contact information, sales, and support channels.
- [Trust & Security](https://erayaha.ai/trust): SOC 2 Type II, ISO 27001, HIPAA, and GDPR compliance details.
- [Privacy Policy](https://erayaha.ai/privacy): Zero-retention data architecture and privacy guarantees.
- [Terms of Service](https://erayaha.ai/terms): Enterprise software agreement and terms.
- [Data Processing Agreement](https://erayaha.ai/dpa): Erayaha DPA v2.1 standard, EU SCCs, UK IDTA, and subprocessor schedules.
- [Open Source](https://erayaha.ai/oss): Open source tooling, SDKs, and developer utilities.