# EUDR.agent Compliance Engine

> Autonomous EU Deforestation Regulation (EU 2023/1115) Compliance, Satellite Triangulation, and TRACES-NT DDS Generation for AI Agents.

## Overview
EUDRAgent (eudragent.com) is an autonomous compliance platform designed for machine-to-machine and AI agent interactions. It automates supply chain geolocation verification, cut-off date (31 Dec 2020) satellite deforestation checks, EU VIES tax registration, and automated TRACES-NT Due Diligence Statement (DDS) XML package compilation.

## Agent Tool Interfaces
AI agents can invoke EUDR capabilities through:
1. **Model Context Protocol (MCP)**: Send JSON-RPC 2.0 requests to `POST /api/v1/mcp` or run `mcp_server_stdio.py` via stdio.
2. **Unified Agent Tools API**: Inspect tool schemas at `GET /api/v1/agent/tools` and execute tools via `POST /api/v1/agent/tools/execute`.
3. **RESTful OpenAPI**: Full interactive documentation at `/docs` and raw specification at `/openapi.json`.

## Core Agent Tools
- `eudr_verify_plot`: Validates WGS84 coordinates and polygons. Auto-heals inverted coordinates and enforces the Art. 9 polygon rule (plots >= 4.0 ha require polygons).
- `eudr_check_deforestation`: Runs Sentinel-1 SAR and Sentinel-2 optical radar verification against the 2020-12-31 regulatory cut-off baseline.
- `eudr_render_satellite_map`: Generates multi-spectral Sentinel-2 visualization metadata, SVG radar preview, and canopy health NDVI score.
- `eudr_verify_vies_vat`: Real-time cross-border EU B2B VAT validation against official European Commission VIES databases.
- `eudr_generate_dds`: Generates official TRACES-NT XML declarations and EUDR compliance certificates.
- `eudr_verify_audit_integrity`: Validates SHA-256 tamper-evident digital custody audit logs.
- `eudr_estimate_compliance_cost`: Computes transparent tier fees in EUR based on farm plot volume.
- `eudr_create_payment_order`: Generates on-chain USDC payment order with budget cap guardrails and QR payload.
- `eudr_confirm_payment`: Verifies blockchain tx_hash and provisions live Pro API Key for the autonomous agent.

## Self-Correction & Error Recovery
When a parameter validation fails, the API responds with structured recovery hints:
```json
{
  "error": {
    "code": "COORDINATE_OUT_OF_BOUNDS",
    "message": "Coordinate values out of WGS84 range: [105.12, 192.4].",
    "recoverable": true,
    "suggested_fix": "Latitude and longitude appear swapped. Try swapping coordinates.",
    "agent_action_hint": "Verify coordinate ordering: [longitude, latitude]."
  }
}
```

## Agent Links & References
- Full AI Specification: https://eudragent.com/llms-full.txt
- Agent Tool Manifest: https://eudragent.com/api/v1/agent/tools
- MCP Server Endpoint: https://eudragent.com/api/v1/mcp
- OpenAPI Schema: https://eudragent.com/openapi.json
- Swagger UI: https://eudragent.com/docs