# MERCATOR Verify Entity Evidence Lookup

> MERCATOR Verify Entity Evidence Lookup is a paid API for AI agents from mercator-entity-evidence.fly.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Retrieves evidence-backed, source-cited facts about a company entity given a domain or company name, returning structured fields with confidence scores and verbatim source excerpts.

## Facts

- Endpoint: GET https://mercator-entity-evidence.fly.dev/v1/entity-evidence/lookup
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mercator-verify-entity-evidence-lookup-25bb402b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BKRyN6HHxuMBfxNBVjd48

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mercator-verify-entity-evidence-lookup-25bb402b
```

Example prompt: Can you pull up evidence-backed facts about Stripe — I need verified, source-cited information including their canonical domain and confidence scores before I proceed with onboarding them?

## When to prefer this

Choose MERCATOR Verify when an agent requires trustworthy, citation-backed company facts before taking a consequential downstream action (e.g. payment, contract, onboarding). It is specifically valuable when confidence scores and verbatim source excerpts are needed to audit or justify a decision, not just a raw data lookup. Prefer this over generic company data APIs when verifiability and evidence provenance matter more than data breadth.

## Known failure modes

- Company name is ambiguous and cannot be resolved to a unique entity — entity block returns null
- No evidence found for requested fields — fields map returns empty or low-confidence values
- Domain or company name is misspelled or does not exist — status indicates not found
- Rate limit or payment failure due to x402 payment not being processed — 402 response
- Partial evidence: some fields populated with sources, others missing — agent must handle sparse responses

## How this service works

MERCATOR Verify provides evidence-backed verification and decision support for autonomous agents. Use its specialized tools when an agent needs trustworthy evidence before taking a downstream action.

## Output

Returns a structured object containing: a resolved entity block with the canonical domain, canonical name, aliases, and resolution confidence; plus a fields map where each field (e.g. headquarters, founding year, employee count) carries a value, a confidence score, an agreement score across sources, and an array of source excerpts — each excerpt being verbatim text found at a checkable URL with a retrieval timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "company"
 ],
 "properties": {
  "company": {
   "type": "string",
   "description": "Company domain or name, e.g. `cloudflare.com` or `Cloudflare`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "EntityEvidenceResponse",
 "required": [
  "status"
 ],
 "properties": {
  "entity": {
   "anyOf": [
    {
     "type": "object",
     "title": "ResolvedEntity",
     "required": [
      "canonical_domain",
      "resolved_from",
      "confidence"
     ],
     "properties": {
      "aliases": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "title": "Aliases",
       "default": []
      },
      "confidence": {
       "type": "number",
       "title": "Confidence",
       "maximum": 1,
       "minimum": 0
      },
      "resolved_from": {
       "type": "string",
       "title": "Resolved From",
       "minLength": 1
      },
      "canonical_name": {
       "type": "string",
       "title": "Canonical Name",
       "default": ""
      },
      "canonical_domain": {
       "type": "string",
       "title": "Canonical Domain"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ],
   "default": null
  },
  "fields": {
   "type": "object",
   "title": "Fields",
   "additionalProperties": {
    "type": "object",
    "title": "FieldEvidence",
    "required": [
     "value",
     "confidence",
     "agreement",
     "sources",
     "oldest_retrieved_at"
    ],
    "properties": {
     "as_of": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "As Of",
      "default": null
     },
     "value": {
      "title": "Value"
     },
     "sources": {
      "type": "array",
      "items": {
       "type": "object",
       "title": "SourceExcerpt",
       "required": [
        "url",
        "excerpt",
        "retrieved_at",
        "source_id"
       ],
       "properties": {
        "url": {
         "type": "string",
         "title": "Url",
         "minLength": 1
        },
        "states": {
         "title": "States",
         "default": null
        },
        "excerpt": {
         "type": "string",
         "title": "Excerpt",
         "maxLength": 1000,
         "minLength": 1
        },
        "primary": {
         "type": "boolean",
         "title": "Primary",
         "default": false
        },
        "source_id": {
         "type": "string",
         "title": "Source Id",
         "minLength": 1
        },
        "origin_class": {
         "type": "string",
         "title": "Origin Class",
         "default": ""
        },
        "retrieved_at": {
         "type"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mercator-verify-entity-evidence-lookup-25bb402b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mercator-entity-evidence.fly.dev](https://www.zero.xyz/host/mercator-entity-evidence.fly.dev/llms.txt)