# Oro Intel examples

A common flow: you have a company name, and you want its full procurement picture.

## Company by name → full profile

```bash
# 1. Find the company (5 credits)
curl -s "https://api.oro-intel.com/v1/companies/search?name=Capita" \
  -H "Authorization: Bearer $ORO_KEY"
# -> { "id": "...", "name": "CAPITA PLC", "companies_house_number": "02081330",
#      "credits_charged": 5, "credits_remaining": 245 }

# 2. Pull the full profile (12 credits)
curl -s "https://api.oro-intel.com/v1/companies/02081330/profile" \
  -H "Authorization: Bearer $ORO_KEY"
# -> { "core": {...}, "contracts": { "contract_count": 132, "items": [...] },
#      "credits_charged": 12, "credits_remaining": 233 }
```

## From MCP

Call `oro_company_profile` with `{ "company_number": "02081330" }` (or
`{ "name": "Capita" }`) for the same result. The tool resolves the company and returns
the core record plus every won contract in one call, charging 12 credits on success.

## Tips

- Send a stable `Idempotency-Key` header per logical request so retries never double-bill.
- Check `credits_remaining` on each response and top up before you hit zero.
- Prefer the profile bundle over separate lookups when you need the whole picture — it's cheaper.