# Amalgix v1.0.0 — Complete API Reference (5 Paid + 2 Free Tools)

> Mixture-of-Agents (MoA) document intelligence engine.
> Pay-per-request with USDC via x402 protocol. No API keys. No subscriptions.
> Crucible™ multi-model Actor-Critic pipeline: Workers + Critics + Manager cross-verify findings.

## Free Endpoints (no payment required)

- GET /               — Landing page
- GET /health         — Service health: uptime status
- GET /llms.txt       — Concise AI discovery (this format)
- GET /llms-full.txt  — Complete API reference (this file)
- GET /openapi.json   — OpenAPI 3.1.0 specification
- POST /mcp           — MCP endpoint (tools/list, initialize, ping — free)

────────────────────────────────────────────────

## MCP Tools — POST /mcp (JSON-RPC 2.0)

All tools are accessed via a single endpoint using the MCP protocol.
Transport: Streamable HTTP (POST /mcp with Content-Type: application/json)

### 📄 analyze_document — Deep Document Analysis
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| content | string | Yes | Document content (text, base64 PDF) |
| source_url | string | No | Source URL for reference |
| analysis_type | string | No | Type: comprehensive, financial, legal, technical |
| output_format | string | No | Format: structured, narrative, bullet_points |
| max_tokens | integer | No | Max tokens for response |
Price: $0.08–$15.00 (dynamic, based on document size)
Pipeline: Ingest → Crucible™ → Cross-Verify → Validate → Output

### 🌐 extract_web — Web Content Extraction
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| url | string | Yes | URL to extract content from |
| analyze | boolean | No | Run Crucible™ analysis on extracted content |
| js_render | boolean | No | Enable JavaScript rendering |
Price: $0.01–$5.00

### 📝 summarize — Fast Summarization
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| content | string | Yes | Content to summarize |
| max_length | integer | No | Maximum summary length |
| style | string | No | Style: executive, technical, casual |
Price: $0.01–$10.00

### 💻 delegate_coding — Code Intelligence
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| mode | string | Yes | Mode: generate, review, extract |
| content | string | Yes | Code or description |
| language | string | No | Programming language |
Price: $0.01–$10.00

### 🌍 delegate_bulk_translate — Bulk JSON Translation
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| content | object/array | Yes | JSON to translate |
| target_language | string | Yes | Target language code |
Price: $0.01–$10.00

### 💰 estimate_cost — Cost Preview (FREE)
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| tool_name | string | Yes | Tool to estimate cost for |
| content_size | integer | No | Approximate content size in bytes |

### 🏥 health_check — Service Status (FREE)
No parameters required.

────────────────────────────────────────────────

## Pricing Model

Dynamic pricing based on document size tier:

| Tier | Size | Price Range | Pipeline |
|------|------|------------|----------|
| L1 Lightweight | < 128KB | $0.08–$0.20 | Single Haiku call |
| L2 Standard | 128KB–3.2MB | $0.16–$5.77 | Haiku extract + cross-provider verify |
| L3 Enterprise | 3.2MB–20MB | $5.77–$15.00 | Chunked MoA: 2× Flash + Haiku critic + Sonnet manager |

Payment: USDC on Base or Solana (ExactScheme, dynamic per-request pricing)
Use estimate_cost to get exact pricing before paying.

## Technical Features
- Crucible™ Engine: Mixture-of-Agents (MoA) architecture with intelligent model routing
- Cross-Model Verification: CoVe protocol — Workers + Critics from different providers validate each other
- 100% Accuracy: Benchmarked across 10 languages on real enterprise documents
- Knowledge Graph Grounding: Entity extraction with relationship mapping
- Schema-Enforced Output: Structured JSON with Zod validation
- PII Redaction: Automatic sensitive data removal
- Self-Healing: Autonomous error recovery with circuit breakers
- Rate Limiting: 60 requests/minute per IP
- Concurrency Gate: Max 5 simultaneous paid requests

## Discovery Files
- /llms.txt — Concise version
- /llms-full.txt — This file (complete reference)
- /openapi.json — OpenAPI 3.1.0 spec
- /.well-known/x402 — x402 resource list
- /.well-known/x402.json — Enriched x402 discovery
- /.well-known/mcp.json — MCP discovery
- /.well-known/mcp/server-card.json — Smithery card
- /.well-known/ai-plugin.json — AI plugin manifest
- /.well-known/agent-card.json — A2A protocol agent card
- /.well-known/agents.json — API discovery for LLM orchestrators
- /sitemap.xml — XML sitemap

## Contact
- Website: https://amalgix.io
- Email: support@amalgix.io