🌲 EUDRAgent.com | Autonomous EUDR Compliance & TRACES-NT DDS Platform

EUDRAgent is an enterprise-grade autonomous compliance automation and Due Diligence Statement (DDS) generation engine for the European Union Deforestation Regulation (Regulation (EU) 2023/1115).

📽️ 4-Step Instant Demo (2s Audit)

💡 Why EUDR Agent? (Instant Problem Solver)

🧭 The 4-Step Flow: 1. UPLOAD ➔ 2. SCAN ➔ 3. VERIFY ➔ 4. EXPORT

📌 Live Cloud Portals & Access Points

🤖 Model Context Protocol (MCP) Integration (Glama.ai Ready)

EUDRAgent includes a native Model Context Protocol (MCP v2024-11-05) server, allowing AI assistants like Claude Desktop, Cursor, Antigravity, and Zed to autonomously perform EUDR compliance audits.

Install via Smithery CLI

To automatically install and configure for Claude Desktop:

npx -y @smithery/cli install nohosa001/eudr-compliance-agent --client claude

Quick Setup for Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "eudr-compliance": {
      "command": "python",
      "args": [
        "/path/to/eudr-compliance-agent/mcp_server_stdio.py"
      ]
    }
  }
}

Remote MCP Server Setup (HTTP Transport)

{
  "mcpServers": {
    "eudr-compliance-cloud": {
      "url": "https://eudragent.com/api/v1/mcp"
    }
  }
}

30 Registered Autonomous Agent Tools

🏛️ Core Architecture & The 4 EUDR Pillars

EUDR Supply Chain Payload (JSON / CSV / GeoJSON / Shapefile)
                           │
                           ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 1. Geodesic Spatial & Topology Engine (SpatialValidator)                │
│    - Strict Article 9(1)(d) 4-Hectare Rule Enforcement                  │
│    - Sub-second WGS84 Geodesic Ellipsoidal Area Calculation (GRS80/WGS84)│
│    - Autonomous Polygon Self-Healing (Self-Intersection & Spike Repair) │
└────────────────────────────────────┬────────────────────────────────────┘
                                     │
                                     ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 2. Multi-Constellation Satellite Radar (DeforestationAnalyzer)          │
│    - Strict Cut-off Baseline: 31 December 2020                          │
│    - Copernicus Sentinel-2 (NDVI 10m Multi-Spectral Monitoring)         │
│    - Hansen Global Forest Change (GFC) Annual Loss Detection            │
│    - JRC Global Forest Cover & Canopy Density Triangulation             │
└────────────────────────────────────┬────────────────────────────────────┘
                                     │
                                     ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 3. Legal Document & Risk Benchmarking Auditor (LegalAuditor)            │
│    - EU Country Risk Benchmarking (Low / Standard / High Risk Tiers)    │
│    - Origin Legality Verification (Land Titles, Harvest Permits)        │
│    - Free, Prior, and Informed Consent (FPIC) for Indigenous Peoples    │
└────────────────────────────────────┬────────────────────────────────────┘
                                     │
                                     ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 4. Cryptographic TRACES-NT DDS Statement Generator (DDSGenerator)       │
│    - EU Customs Direct B2G Submission Payload Packaging                 │
│    - HMAC-SHA256 Cryptographic Digital Signature & Merkle Audit Trail   │
│    - Article 31 (5-Year Record Retention) Immutable Evidence Bundle    │
└─────────────────────────────────────────────────────────────────────────┘

🚀 Quick Start Guide (Local Development)

1. Installation

# Clone the repository
git clone https://github.com/nohosa001-pixel/eudr-compliance-agent.git
cd eudr-compliance-agent

# Create and activate virtual environment
python -m venv .venv
.\.venv\Scripts\activate      # Windows
source .venv/bin/activate       # Linux / macOS

# Install dependencies
pip install -r requirements.txt

2. Run Local Development Server

uvicorn app.main:app --reload --port 8000

Open your browser at http://localhost:8000 to view the SaaS Landing Page or http://localhost:8000/dashboard for the Operator Console.

3. Run Test Suite

pytest -v tests/

Runs the full suite of 75 automated tests (Spatial validation, satellite loss detection, legal auditing, PostGIS integration, and API security).

🔑 Programmatic API & ERP Integration

1. Generate SaaS API Key

curl -X POST "http://localhost:8000/api/v1/auth/api-keys" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Global Timber & Coffee Trading Ltd",
    "contact_email": "compliance@company.com",
    "tier": "PRO"
  }'

2. Submit Compliance Due Diligence Evaluation

curl -X POST "http://localhost:8000/api/v1/eudr/evaluate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: eudr_live_YOUR_KEY_HERE" \
  -d '{
    "operator_id": "VN-EXP-COFFEE-8821",
    "operator_name": "Highland Agri Export Ltd",
    "commodity": "COFFEE",
    "hs_code": "0901.11.00",
    "product_description": "Arabica Green Coffee Beans Premium Grade",
    "net_mass_kg": 24000.0,
    "plots": [
      {
        "plot_id": "VN-LAMDONG-001",
        "country_code": "VN",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [108.4380, 11.9400],
              [108.4420, 11.9400],
              [108.4420, 11.9435],
              [108.4380, 11.9435],
              [108.4380, 11.9400]
            ]
          ]
        },
        "declared_area_ha": 17.5,
        "production_date_start": "2023-10-01",
        "production_date_end": "2023-11-15",
        "producer_name": "Da Lat Arabica Cooperative"
      }
    ],
    "documents": [
      {
        "document_type": "LAND_TITLE",
        "document_id": "LURC-VN-2018-990",
        "country_code": "VN",
        "issuing_authority": "Lam Dong Department of Natural Resources",
        "issue_date": "2018-05-12",
        "expiry_date": "2038-05-12",
        "plot_ids": ["VN-LAMDONG-001"]
      }
    ]
  }'

☁️ Production Cloud Deployment

1. Deploy to Google Cloud Run (One-Click)

.\deploy_gcp.ps1

Builds the container and deploys to Google Cloud Run in asia-northeast3 (Seoul) with auto-scaling, HTTPS, and custom domain mapping.

2. Deploy via Docker Compose & Nginx SSL

# Copy and configure environment variables
cp .env.production.example .env.production
nano .env.production

# Execute deployment script
chmod +x deploy.sh
./deploy.sh

📋 Regulated Annex I Commodities

EUDRAgent provides automatic classification and compliance verification for all 7 Annex I commodity categories:

• ☕ Coffee (HS Chapter 0901)
• 🍫 Cocoa (HS Chapter 1801–1806)
• 🌴 Oil Palm (HS Chapter 1511, 1207, 2306, 2905, 3823)
• 🪵 Wood & Timber (HS Chapter 4401–4421, 4701–4707, 4801–4823, 9401, 9403)
• 🌱 Soya (HS Chapter 1201, 1208, 1507, 2304)
• 🚲 Rubber (HS Chapter 4001, 4005, 4006, 4007, 4008, 4011, 4012)
• 🥩 Cattle / Beef & Leather (HS Chapter 0102, 0201, 0202, 4101, 4104, 4107)

⚖️ Legal & Regulatory Disclaimer

This software is designed to assist operators and traders in complying with their obligations under Regulation (EU) 2023/1115. Operators remain legally responsible for the final submission of Due Diligence Statements to EU competent authorities via TRACES-NT.

📄 License

Released under the MIT License. Copyright © 2026 EUDRAgent.com. All rights reserved.