# Oro Intel for agents — Overview

Oro Intel is UK public-procurement intelligence. Browsing and searching notices and
contracts on the web is free. Structured, agent-ready data — company profiles,
contracts, buyers — is metered in credits and available identically over a REST API
and an MCP server.

## Authentication

Create an API key in the web app under **Developers** (or Settings → Billing → API
keys) at https://app.oro-intel.com/dashboard/developers. The full key is shown once.
Send it as a bearer token:

```
Authorization: Bearer oro_xxxxxxxxxxxx
```

- REST + OpenAPI 3.1: `https://api.oro-intel.com/v1/*` (spec at `https://api.oro-intel.com/openapi.json`)
- MCP (streamable HTTP): `https://api.oro-intel.com/mcp/` (keep the trailing slash)

## Credits

New accounts get **250 free credits**. 1 credit = £0.01 net. Top up in the web app.
Every metered response includes `credits_charged` and `credits_remaining`. You are
charged on **success only** — a lookup that returns nothing is not billed. Pass an
`Idempotency-Key` header so retries never double-bill.

When you run out, you get a 402-style body:

```json
{
  "error": "insufficient_credits",
  "action": "company_profile",
  "required": 12,
  "balance": 4,
  "top_up_url": "https://app.oro-intel.com/dashboard/settings/billing"
}
```

## Next

- REST API: https://documentation.oro-intel.com/api.md
- MCP server: https://documentation.oro-intel.com/mcp.md
- Examples: https://documentation.oro-intel.com/examples.md