Tracea

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Tracea — legal identity (Know Your Agent) for AI agents, on-chain. ERC-8004 compatible.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Tracea": {
      "url": "https://mcp.tracea.online/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (23)

• verify_agent

  Verify an AI agent's on-chain legal identity on Tracea (Base Sepolia). Returns registration status, financial cap, permission scope, revocation status, and KYA legal identity (mandant) when available. Use this BEFORE trusting or delegating work to an agent.

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent (0x...)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_agent_info

  Get the raw Tracea registry record for an agent: owner, permission scope, financial cap, active status, timestamps.

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• is_agent_revoked

  Check whether an agent's mandate has been revoked on Tracea (immediate, scheduled or partial revocation).

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_owner_agents

  List all agent addresses registered on Tracea by a given owner address.

  Parameters:

  • owner_address (required) — string — Ethereum address of the owner

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_action

  Read a single logged agent action from the Tracea ActionLog contract by its numeric ID. Returns agent, action type, payload and timestamp.

  Parameters:

  • action_id (required) — integer — Numeric action ID

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_agent_actions

  List all on-chain action IDs logged for a given agent on Tracea.

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• log_action

  Log an agent action on-chain via Tracea (immutable audit trail, court-ready). Requires TRACEA_API_KEY env var. The action is signed by the account's wallet.

  Parameters:

  • agent_address (required) — string — Ethereum address of the acting agent
  • action_type (required) — string — Short action type, e.g. 'email_sent', 'payment_initiated'
  • data — string — Optional human-readable payload (JSON string recommended)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_registration_file

  Fetch the ERC-8004 compatible registration file for a Tracea-registered agent, including the KYA legal principal block.

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• report_activity

  Report an action the agent just performed to its owner's Tracea activity feed (off-chain, free, instant). Call this AFTER every significant action (email sent, message posted, file modified, payment, purchase, booking...). Auth via the Tracea MCP URL (?key=...) from the agent's identity page, OR self-activate with a one-time activation code (?code=... or x-activation-code header) — the tool then receives its apiKey automatically.

  Parameters:

  • agent_address (required) — string — Ethereum address of this agent
  • category (required) — string — Action category
  • summary (required) — string — Short human-readable summary of what was done
  • details — string — Optional JSON string with extra context
  • in_permission — boolean — false if this action is OUTSIDE the granted permissions (flagged red)
  • permission_label — string — Which owner-granted permission this action falls under

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_my_identity

  Get this agent's full Tracea identity (activity apiKey +, for v2 agents, its EOA private key and ERC-4337 smart account address) using a one-time activation code from the owner. The private key is returned ONLY ONCE — save it securely.

  Parameters:

  • agent_address (required) — string — Ethereum address of this agent
  • activation_code — string — One-time activation code (or use ?code= / x-activation-code)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_payment_whitelist

  Get the list of owner-approved payment destination addresses for an agent (anti-injection guardrail). Non-empty list = the agent's smart account can ONLY pay these addresses. Empty = all allowed.

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• check_payment_allowed

  Dry-run a payment BEFORE executing it: checks on-chain whether the agent's smart account would allow it (permission granted, within financial cap, destination approved if a whitelist exists). Returns { allowed, reason }.

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent (its smart account address)
  • destination (required) — string — Destination address to pay
  • amount_eth (required) — string — Amount in ETH, e.g. '0.001'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• payment_required

  Create a x402 payment request (HTTP 402) for a resource you sell to another agent. Returns a paymentId, the USDC amount in units, the destination address and the TraceaPayments contract to call. The paying agent must then call TraceaPayments.payX402(destination, amount, paymentId) on-chain — the contract enforces financial cap + whitelist on-chain. Deliver the resource only after payment_incoming confirms fulfilment.

  Parameters:

  • destination (required) — string — Address that receives the USDC payment (yours)
  • amount_usdc (required) — string — Amount in USDC, e.g. '0.50' or '2'
  • agent — string — Address of the paying agent, if known
  • resource — string — Identifier/URL of the resource to unlock after payment
  • ttl_seconds — number — Validity of the payment session (30-3600s, default 300)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• payment_incoming

  Verify a x402 payment ON-CHAIN (the USDC transfer to your address, exact amount) and mark the session fulfilled. The blockchain is the ONLY source of truth — the payment_sessions table is never trusted alone. Returns { status: 'fulfilled', resource } if verified, or an error if not yet paid/expired.

  Parameters:

  • payment_id (required) — string — The paymentId returned by payment_required (pay_...)
  • tx_hash (required) — string — The on-chain transaction hash of the USDC transfer / payX402 call

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• payment_status

  Get the status of a x402 payment session (pending | paid | fulfilled | expired), with destination, amount and tx hash. Useful to poll while waiting for the paying agent's on-chain transaction.

  Parameters:

  • payment_id (required) — string — The paymentId returned by payment_required (pay_...)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tracea_list_demarches

  List the administrative procedures Tracea supports. ALWAYS call this first: it returns the exact procedure IDs so the AI never has to guess which form (CERFA) applies. `schemaPret: true` means guided mode (anti-rejection check available) is ready for that procedure.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tracea_demarche_schema

  Return exactly which fields a given administrative procedure requires (name, type, required, format/pattern, bounds, example). Call this after tracea_list_demarches so you ask the user ONLY for the real fields, in the right format. Prevents hallucinated fields.

  Parameters:

  • id (required) — integer — Procedure id returned by tracea_list_demarches (e.g. 15776)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tracea_check_demarche

  THE anti-rejection check. Submit the data you collected; it validates every field against the official procedure schema AND cross-checks critical values against official French registries (e.g. SIRET against INSEE Sirene). Returns { ok: true, recordHash } or { ok: false, errors: [{ field, message }] }. ALWAYS call this BEFORE telling the user the file is ready, and fix the exact fields reported.

  Parameters:

  • id (required) — integer — Procedure id (e.g. 15776)
  • donnees (required) — object — Collected data as a flat object, field names exactly as in tracea_demarche_schema

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tracea_anchor_demarche

  Seal a validated file as an immutable on-chain proof (Tracea Online, Base). Call this ONLY after tracea_check_demarche returned ok:true — it re-checks everything before anchoring. Requires the caller to be an authorized harness. Returns the proof fingerprint and the record hash.

  Parameters:

  • id (required) — integer — Procedure id (e.g. 15776)
  • donnees (required) — object — Same data object that passed tracea_check_demarche
  • agent (required) — string — Ethereum address (0x...) of the agent smart account that judged the file compliant

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tracea_demarche_preuve

  Verify an existing proof: was this file really anchored, when, by which operator, and under which rule version? Use the recordHash returned by tracea_check_demarche / tracea_anchor_demarche. Read-only and free.

  Parameters:

  • hash (required) — string — recordHash (0x... 32 bytes) returned by tracea_check_demarche or tracea_anchor_demarche

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tracea_demarche_document

  Prepare le document officiel d'une demarche (CERFA ou demarche libre) et le rend signable. Appelle le generateur du backend Tracea, enregistre le dossier pour l'agent du visiteur et renvoie la reference + le chemin du PDF. A appeler APRES tracea_check_demarche (ok:true) et AVANT tracea_signature. Si des champs manquent, renvoie ok:false + champsManquants : ne fabrique jamais un document partiel.

  Parameters:

  • id (required) — integer — Procedure id (ex: 26002)
  • donnees (required) — object — Donnees validees, memes champs que tracea_demarche_schema
  • agent (required) — string — Adresse Ethereum (0x...) de l'agent du visiteur, celle de l'identite de la conversation. Ne jamais l'inventer.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tracea_signature

  DEPOSE REELLEMENT le document prepare dans Tracea Sign : cree les signataires, place la zone de signature, produit un lien de signature par personne et envoie les invitations. Exige pdfPath et signataires. Sans eux, aucun lien n'est renvoye.

  Parameters:

  • id — integer — Procedure id (informatif)
  • box — string — Zone de signature 'x,y,w,h' (defaut: detection sur le PDF)
  • titre — string — Titre du document vu par le signataire
  • niveau — string — Environnement — demo par defaut
  • envoyer — boolean — Envoyer les invitations (defaut: true)
  • pdfPath — string — Chemin du PDF prepare, ex: /root/workspaces/<id>/attestation.pdf
  • signataires — array — Adresses e-mail des signataires

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_verification_card

  Get the public URL of an agent's Tracea KYA verification card — the shareable page that presents the mandant entity, the permission scope, the financial cap and a proof hash, with a bilingual FR/EN transparency statement. Use it to hand a verifier a link. Returns the ready-to-share link plus the machine-readable JSON endpoints. Defaults to the 'standard' disclosure level, which is what the API exposes publicly.

  Parameters:

  • agent_address (required) — string — Ethereum address of the agent (0x...)
  • lang — string — Card language; the card also auto-detects the visitor's browser language
  • niveau — string — Disclosure level: minimum | standard (default) | complet

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.