Buyer intelligence — activity, concentration, recurrence

An agent needs a buyer profile: award history, supplier concentration (top-supplier share) and per-CPV recurrence so it can time outreach.

Tools

GET /v1/buyers/:id/history ($0.05/call). MCP: get_buyer_history.

Example response (labeled sample)

# GET /v1/buyers/:id/history  ($0.05 USDC)
→ {"data": {"id": 1680, "name": "Alcaldía del Ayuntamiento de Oleiros", "awards_total": 1,
   "supplier_concentration": 1.0, "recurrence": [{"cpv": "79000000", "median_months": null}]},
   "meta": {"paid": true, "price_usd": "0.05"}}

Honesty note

Concentration/recurrence are derived from indexed awards; small histories can show 1.0 concentration — read counts alongside ratios. Every response exposes meta.provenance.

all use cases