# agent-2-agent-tunisia

> 11 Tunisian public-data services for AI agents: QANAT, ZITOUN, MIZAN, NOUR, EXPORTPASS, BED BANK, ZAYTOUN, MARCHÉ, PANIER, COUVERT, SANAD.
> Every answer carries a source hash, explicit gaps and an Ed25519 attestation.

Base URL: https://tunis-data.hanibal-ai.com
Payment: x402 v2, exact, eip155:8453, USDC, mode=live
MCP: https://tunis-data.hanibal-ai.com/mcp (streamable HTTP, protocol 2025-06-18)
OpenAPI: https://tunis-data.hanibal-ai.com/openapi.json
Discovery: https://tunis-data.hanibal-ai.com/.well-known/x402
Manifest: https://tunis-data.hanibal-ai.com/.well-known/x402.json
Capabilities: https://tunis-data.hanibal-ai.com/.well-known/capabilities.json
Issuer: did:web:tunis-data.hanibal-ai.com (https://tunis-data.hanibal-ai.com/.well-known/did.json)
Verify an attestation: POST https://tunis-data.hanibal-ai.com/api/v1/attest/verify with {"document": <signed envelope>}

## Free discovery
- qanat_catalog_search: /api/v1/qanat/catalog — Search the normalized Tunisian public-data catalogue by keyword.
- qanat_series_meta: /api/v1/qanat/series — Definition, unit, frequency, coverage, source and gaps for one series.
- qanat_data_health: /api/v1/qanat/health — Last extraction, validation status and open gaps across all series.
- zitoun_provenance: /api/v1/zitoun/provenance — Free provenance call: source, extraction checks, conflicts and gaps.

## Paid tools
### QANAT — Give me the official monthly series for X, with source and stable resource ids.
- qanat_series_query: /api/v1/qanat/series/query — $0.02 USDC — Observations for a series, with source page and confidence per point.
- qanat_observation: /api/v1/qanat/observation — $0.01 USDC — One observation with its source page and provenance.

### ZITOUN — What does Tunisian olive oil cost this campaign in bulk and packaged, and what is the uplift?
- zitoun_campaign_summary: /api/v1/zitoun/campaign-summary — $0.01 USDC — Olive-oil campaign volume, value, average price and bulk/packaged split.
- zitoun_price_series: /api/v1/zitoun/price-series — $0.02 USDC — Average export price by category for the campaign; monthly gaps are explicit.
- zitoun_spread_analysis: /api/v1/zitoun/spread-analysis — $0.05 USDC — Bulk-to-packaged uplift and the bio premium, including conflicting source values.
- zitoun_destination_mix: /api/v1/zitoun/destination-mix — $0.02 USDC — Destination shares by quantity and the bio destination mix, with basis and page.

### MIZAN — How much of Tunisia's food imports are covered by exports, and where does it break?
- mizan_balance: /api/v1/mizan/balance — $0.02 USDC — Cumulative food trade balance, exports, imports and coverage ratio.
- mizan_dependency: /api/v1/mizan/dependency — $0.03 USDC — Import dependence by product, with value share of total food imports.
- mizan_price_watch: /api/v1/mizan/price-watch — $0.02 USDC — Export and import prices by product, with year-on-year changes.
- mizan_monthly_series: /api/v1/mizan/monthly-series — $0.02 USDC — Cumulative balance points. Monthly values are returned only when verified.

### NOUR — What are Deglet Nour dates worth this season, and where do they go?
- nour_campaign: /api/v1/nour/campaign — $0.01 USDC — Date production, 2021 annual exports and 2026 Jan-Aug exports.
- nour_prices: /api/v1/nour/prices — $0.02 USDC — Verified annual and year-to-date date prices; no fabricated monthly series.
- nour_destinations: /api/v1/nour/destinations — $0.02 USDC — Destination shares, or an explicit gap when the source has no machine-readable table.
- nour_bio_premium: /api/v1/nour/bio-premium — $0.03 USDC — Organic date volumes, prices and premium, or an explicit gap.

### EXPORTPASS — Which documents and rules apply to 20 t of organic dates to Germany?
- exportpass_requirements: /api/v1/exportpass/requirements — $0.05 USDC — Source-linked EU import requirements for dates or olive oil. Not legal advice.
- exportpass_document_checklist: /api/v1/exportpass/document-checklist — $0.03 USDC — Document checklist with always / conditional / verify status.
- exportpass_supplier_lookup: /api/v1/exportpass/supplier-lookup — $0.05 USDC — Checks a public register; refuses to assert credibility without a source.
- exportpass_tariff_lookup: /api/v1/exportpass/tariff-lookup — $0.02 USDC — HS code and official tariff query link; the duty rate is deliberately null.

### BED BANK — How many hotel beds are actually bookable, and which houses are offline?
- bedbank_zone_capacity: /api/v1/bedbank/zone-capacity — $0.05 USDC — National hotel capacity and closed beds; zone splits only when verified.
- bedbank_hotel_status: /api/v1/bedbank/hotel-status — $0.03 USDC — Returns a named hotel only if a dated public register backs it; otherwise refuses.
- bedbank_offline_watch: /api/v1/bedbank/offline-watch — $0.05 USDC — Aggregate closed capacity and closure reasons; no named hotels.
- bedbank_reopening_pipeline: /api/v1/bedbank/reopening-pipeline — $0.05 USDC — Announced reopenings only when a verified list exists; otherwise explicit gap.

### ZAYTOUN — Buy, hold or switch olive-oil origin now, with a max-price guardrail?
- zaytoun_decide: /api/v1/zaytoun/decide — $0.05 USDC — Olive-oil buy/hold decision from the latest ONAGRI balance + dashboard: price gap, production, FX and a max-price guardrail.

### MARCHÉ — Keep, expand, diversify or reduce an export market?
- marche_allocate: /api/v1/marche/allocate — $0.04 USDC — Destination allocation decision for Tunisian exports: keep, expand, diversify or reduce a market, with corrected EU share.

### PANIER — Absorb, pass through, reprice or reformulate food inflation?
- panier_reprice: /api/v1/panier/reprice — $0.03 USDC — Food-inflation pass-through decision: absorb, pass through, reprice or reformulate, using the official IPC sub-indices.

### COUVERT — Hedge now, partially or wait on a foreign-currency payable?
- couvert_hedge: /api/v1/couvert/hedge — $0.05 USDC — FX hedge decision for a Tunisian importer payable: hedge now, partially or wait, with the BCT table date as as_of.

### SANAD — Release, query or reject a shipment dossier?
- sanad_release: /api/v1/sanad/release — $0.10 USDC — Release/query/reject a Tunisian shipment dossier: upload a PDF via POST /api/v1/sanad/uploads and pass upload_id, or use upload_id=sample for the built-in demo dossier.

## Honesty contract
- Missing data is `null`, `available: false` or listed in `gaps`. It is never estimated.
- Conflicting published values are returned with both numbers.
- The data is an unofficial compilation, not an official statement by ONAGRI, ONTT or the EU.