# Tropical Autonome — Caribbean Data Marketplace
# Single entry point for AI agents accessing Caribbean structured data
# Operator: Frederick Martel — Lamentin, Guadeloupe (971)
# Contact: tropicalautonome@gmail.com
# Updated: 2026-08-22

## MCP SERVER (recommended for AI agents)

Native MCP integration — no URL required, tools auto-discovered by Claude and MCP clients.
Endpoint: POST https://tropical-data-api.tropicalautonome.workers.dev/mcp
Protocol: MCP 2024-11-05 — Streamable HTTP — 15 tools available
Free tools: caribbean_list_marketplace, caribbean_get_provider, caribbean_get_llms_txt
Paid tools: all data endpoints (USDC on Base — x402 protocol)

## PAYMENT PROTOCOL

All paid endpoints use HTTP 402 (x402 protocol).
Currency: USDC on Base network (L2 Ethereum).
Workflow:
  1. Call endpoint → receive 402 with price_usdc and wallet address
  2. Send exact USDC amount to that address on Base network
  3. Retry with header: X-Payment: 0x{transaction_hash}

## OPERATOR ENDPOINTS — Tropical Autonome (direct pricing, no commission)

GET /api/v1/edf-oa/tarifs-zni — 0.020 USDC
GET /api/v1/raccordement/guadeloupe — 0.020 USDC
POST /api/v1/analyse/rentabilite-solaire — 0.500 USDC
GET /api/v1/fiscalite/244-quater-w — 0.100 USDC
GET /api/v1/financement/dom-energies — 0.050 USDC
GET /api/v1/biodiversite/guadeloupe — 0.050 USDC
GET /api/v1/biodiversite/edna-caraibes — 0.100 USDC
GET /api/v1/biodiversite/credits — 0.100 USDC
GET /api/v1/caye/vanille — 0.050 USDC
GET /api/v1/caye/vetiver — 0.050 USDC
GET /api/v1/caye/marche-premium — 0.050 USDC
GET /api/v1/foncier/agricole-dom — 0.050 USDC
GET /api/v1/peche/artisanale-caraibes — 0.050 USDC
GET /api/v1/pme/guadeloupe — 0.050 USDC
GET /api/v1/solaire/irradiation-dom — 0.020 USDC
GET /api/v1/tourisme/guadeloupe — 0.050 USDC
GET /api/v1/commerce/import-export — 0.050 USDC
GET /api/v1/infrastructure/eau-dom — 0.050 USDC
GET /api/v1/marches-publics/guadeloupe — 0.030 USDC
GET /api/v1/marches-publics/dom — 0.025 USDC

## MARKETPLACE — Free discovery

GET /marketplace/v1 — FREE
  Full catalogue of all active third-party providers and their endpoints.

GET /marketplace/v1/{provider-slug} — FREE
  Provider card: name, description, verified status, all endpoints with prices.

## MARKETPLACE — Third-party provider endpoints

### Agri Guadeloupe ✓
Données agricoles structurées — filières banane, canne, maraîchage et élevage en Guadeloupe. Issu du réseau de terrain de la Chambre d'Agriculture.
  GET /marketplace/v1/agri-guadeloupe/filieres-banane — 0.0400 USDC
    Filière banane Guadeloupe — volumes, prix départ exploitation, marchés export, aides PAC 2023-2027.
  GET /marketplace/v1/agri-guadeloupe/marche-local — 0.0200 USDC
    Prix du marché local Guadeloupe — légumes, fruits, produits transformés. Relevés hebdomadaires marchés de Pointe-à-Pitre, Basse-Terre, Le Moule.

## PROVIDER SELF-SERVICE (X-Provider-Key header required)

POST /marketplace/v1/{provider}/settle — request USDC payout of earned balance
GET  /marketplace/v1/{provider}/ledger — view balance and transaction history

## TAGS

energie, solaire, zni, dom, fiscalite, financement, biodiversite, edna, credits-biodiversite,
caye, vanille, vetiver, agriculture, peche, tourisme, foncier, meteo, caraibes, guadeloupe

## VERSION

API v2.0 — x402 marketplace — 2026-08-22