---
name: build-with-emable
description: Discover, quote, and safely run governed Emable financial capabilities and use cases through REST or MCP. Use when building an AI agent or application that needs sourced European financial intelligence, explicit permissions, predictable credit cost, citations, or auditable run records.
---

# Build with Emable

1. Read `https://api.emable.ai/v1/capabilities` and `/v1/use-cases` before choosing a tool.
2. Inspect the selected detail contract, version, permissions, evidence freshness, limitations, and supported surface.
3. Quote a use case before execution. Never infer price from an old prompt or cached catalogue.
4. Authenticate with the least-privilege API key or MCP OAuth scopes needed for the call.
5. Send a fresh idempotency key for a new run and reuse it only for an exact retry.
6. Treat `awaiting_approval` as a pause. Do not bypass approval or start outreach.
7. Return citations and source freshness with the result. Keep unavailable metrics unavailable.
8. On `402`, stop and ask the account owner to top up. On `409 commercial_validation_required`, do not retry.
9. Poll the shared run record until `succeeded`, `failed`, or `refused`, then report actual completed-step charges.
10. Never copy raw customer inputs or results into public analytics, logs, or prompts.