ESGOS

API access

The entire directory — organisations, claims, provenance, market briefings — is queryable over one unauthenticated endpoint. It speaks MCP (JSON-RPC over POST), so AI agents can use it natively and scripts can treat it as a plain JSON API.

Endpoint

POST https://esgos.org/mcp — no key, no registration. The server implements initialize, ping, tools/list and tools/call, and negotiates protocol versions 2025-06-18, 2025-03-26 and 2024-11-05. There is no SSE stream: GET answers 405 and says so. Responses are no-store — they echo your request id, so caching them would be wrong.

Tools

  • search_organisations Keyword, market, tier and category filters. Keyword matching covers every record; meaning-based matching, which works across languages, covers the subset with a computed embedding — the payload's matching field (hybrid or keyword) reports which path produced the ranking. Each record carries its verification status. A tier is not the same as a verification: a tier additionally requires the organisation to have claimed its own listing, so most records carry confirmed verifications and no tier, and the tier filter currently returns nothing.
  • get_organisation_profile One organisation with every assertion and its provenance: verifier, standard, date, expiry. verification: null means NOT verified.
  • get_market_briefing Regulatory regimes in force and coming for a market, by ISO country code.
  • list_categories The solution taxonomy; node ids feed search_organisations.
  • exposure_check CN/HS codes (1–50, destination EU) against CBAM and EUDR scope: matching regime, applies-from date, confidence and Official Journal source per code, with explicit no-matches. ESGOS is not an accredited verifier and does not calculate, estimate or attest emissions.
  • find_verified_producers Published organisations with third-party-verified CBAM or EUDR declarations, filterable by code prefix and jurisdiction. Declaration facts only — product codes, verifier, dates, lapsed status; capped at 50 results.

Some organisations show a Member mark on the site: a paid enhanced listing (logo, tagline, longer description, contact form). It is presentation only — it has no effect on verification status or ranking, and it is not exposed through the MCP tools.

Some organisations carry a line “Listed on the … portal”: a portal is a licensed, co-branded view of public data — an institution’s own list filtered over the directory, in directory order. It has no effect on any organisation’s record, tier or ranking, and portals are not exposed through the MCP tools.

Some organisation pages carry a Recognition section: the GREEN AWARDS are editorial recognition by a jury for a specific achievement in a specific year — not a rating, a certification or a label, with no effect on verification status or ranking — and they are not exposed through the MCP tools.

Try it

curl -s https://esgos.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -s https://esgos.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"search_organisations",
        "arguments":{"q":"heat pump","tier":"gold"}}}'

Crawling

Prefer the API for bulk questions. For page crawling: sitemap.xml lists every published page, robots.txt carries our content signals (search and AI input both welcome), and llms.txt is the condensed machine-readable summary.

Using the data

The terms are the same for you as for anyone, including every entity related to ESGOS: free, unauthenticated, no key, no contract, no paid tier and no bulk licence. The distribution policy states that in full and says what paid products do and do not buy.

Free for any use with attribution to esgos.org. One rule matters more than the rest: when you cite a verification, carry its provenance — verifier, standard, date and expiry. A claim without a confirmed verification must never be described as verified. See how verification works and the terms.