MEO Preflight

Before paying an unfamiliar machine service, call this read-only tool to compare the proposed resource, payment destination, network, asset and amount with MEO's dated economic history. Returns observed payment-term matches or changes, settlement/buyer/activity context when available, evidence freshness, and explicit unknowns. It does not execute or approve payment and never interprets missing evidence as safe. Pilot scope: two services; third-party public probe observations retained by MEO, not independently verified settlements. Settlement/buyer history, current activity and payment destination history are UNKNOWN. Evidence may be stale. Invocation example: {"resource_url":"https://blockrun.ai/api/v1/exa/search","pay_to":"0x0000000000000000000000000000000000000001","network":"eip155:8453","asset":"USDC","amount":"0.011"}

{
  "type": "object",
  "properties": {
    "resource_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public HTTPS resource URL, no query, credentials or fragment. Exact resource matching only; never fetched."
    },
    "pay_to": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Proposed recipient; EVM networks require a 0x-prefixed 40-hex-character address. Never logged or interpreted as wallet ownership."
    },
    "network": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9-]+:[a-zA-Z0-9_-]+$",
      "description": "CAIP-style network; v0.1 supports eip155:8453 only."
    },
    "asset": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9:._/-]+$",
      "description": "v0.1 supports source-reported USDC currency label only; no token contract validation."
    },
    "amount": {
      "type": "string",
      "pattern": "^(0|[1-9][0-9]{0,23})(\\.[0-9]{1,6})?$",
      "description": "Nonnegative decimal asset units, maximum six decimal places. Not atomic units. No exponent notation."
    }
  },
  "required": [
    "resource_url",
    "pay_to",
    "network",
    "asset",
    "amount"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "resource_url": "https://blockrun.ai/api/v1/exa/search",
      "pay_to": "0x0000000000000000000000000000000000000001",
      "network": "eip155:8453",
      "asset": "USDC",
      "amount": "0.011"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid"
    },
    "version": {
      "const": "0.1.0"
    },
    "result_state": {
      "type": "string",
      "enum": [
        "HISTORICAL_CONTEXT",
        "MATERIAL_DIFFERENCE",
        "UNKNOWN",
        "UNSUPPORTED"
      ]
    },
    "evidence_outcome": {
      "const": "INSUFFICIENT_EVIDENCE"
    },
    "match_status": {
      "type": "string",
      "enum": [
        "EXACT_RESOURCE",
        "UNRESOLVED"
      ]
    },
    "resolved_service": {
      "anyOf": [
        {
          "type": "null"
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "resource": {
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "id",
            "name",
            "resource"
          ],
          "additionalProperties": false
        }
      ]
    },
    "economic_history": {
      "type": "object",
      "properties": {
        "state": {
          "type": "string",
          "enum": [
            "PAYMENT_TERMS_OBSERVED",
            "UNKNOWN"
          ]
        },
        "settlement_state": {
          "const": "UNKNOWN"
        },
        "observation_count": {
          "type": "integer",
          "minimum": 0
        },
        "payment_term_observation_count": {
          "type": "integer",
          "minimum": 0
        },
        "history_change_state": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "CHANGE_OBSERVED",
            "NO_CHANGE_IN_CAPTURED_TERMS"
          ]
        },
        "payment_destination_history": {
          "const": "UNKNOWN"
        }
      },
      "required": [
        "state",
        "settlement_state",
        "observation_count",
        "payment_term_observation_count",
        "history_change_state",
        "payment_destination_history"
      ],
      "additionalProperties": false
    },
    "current_activity": {
      "type": "object",
      "properties": {
        "state": {
          "const": "UNKNOWN"
        },
        "last_reported_status": {
          "type": [
            "string",
            "null"
          ]
        },
        "observed_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        }
      },
      "required": [
        "state",
        "last_reported_status",
        "observed_at"
      ],
      "additionalProperties": false
    },
    "material_findings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "payment_term_comparisons": {
      "type": "object",
      "properties": {
        "network": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "MATCH",
            "DIFFERENT_FROM_OBSERVED"
          ]
        },
        "asset": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "MATCH",
            "DIFFERENT_FROM_OBSERVED"
          ]
        },
        "amount": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "WITHIN_OBSERVED_RANGE",
            "OUTSIDE_OBSERVED_RANGE"
          ]
        },
        "payTo": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "MATCH",
            "DIFFERENT_FROM_OBSERVED"
          ]
        },
        "observed_terms": {
          "anyOf": [
            {
              "type": "null"
            },
            {
              "type": "object",
              "properties": {
                "networks": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "asset": {
                  "type": "string"
                },
                "amount_min": {
                  "type": "string"
                },
                "amount_max": {
                  "type": "string"
                },
                "payTo": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "networks",
                "asset",
                "amount_min",
                "amount_max",
                "payTo"
              ],
              "additionalProperties": false
            }
          ]
        },
        "observed_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "amount_unit": {
          "const": "decimal_asset_units"
        },
        "basis": {
          "const": "LAST_CAPTURED_TERMS_ONLY"
        }
      },
      "required": [
        "network",
        "asset",
        "amount",
        "payTo",
        "observed_terms",
        "observed_at",
        "amount_unit",
        "basis"
      ],
      "additionalProperties": false
    },
    "evidence_freshness": {
      "type": "object",
      "properties": {
        "state": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "RECENT_SNAPSHOT",
            "STALE"
          ]
        },
        "latest_observed_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "retrieved_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "age_seconds": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "stale_after_seconds": {
          "const": 86400
        }
      },
      "required": [
        "state",
        "latest_observed_at",
        "retrieved_at",
        "age_seconds",
        "stale_after_seconds"
      ],
      "additionalProperties": false
    },
    "evidence_confidence": {
      "type": "object",
      "properties": {
        "strength": {
          "type": "string",
          "enum": [
            "LIMITED",
            "NONE"
          ]
        },
        "basis": {
          "type": "string",
          "enum": [
            "SINGLE_THIRD_PARTY_SOURCE_UNVERIFIED",
            "NO_MATCHING_PUBLIC_EVIDENCE"
          ]
        }
      },
      "required": [
        "strength",
        "basis"
      ],
      "additionalProperties": false
    },
    "evidence": {
      "type": "object",
      "properties": {
        "snapshot_id": {
          "type": "string"
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "required": [
        "snapshot_id",
        "sources"
      ],
      "additionalProperties": false
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "request_id",
    "version",
    "result_state",
    "evidence_outcome",
    "match_status",
    "resolved_service",
    "economic_history",
    "current_activity",
    "material_findings",
    "payment_term_comparisons",
    "evidence_freshness",
    "evidence_confidence",
    "evidence",
    "limitations"
  ],
  "additionalProperties": false
}