# AdSentinel

> Meta (Facebook and Instagram) Ad Library data for AI agents. Every ad a brand runs, fetched live when you ask, with EU reach and audience, billed €3.99 per 1000 ads delivered.

Instructions for agents:

- Brand name to ads: call `find_advertiser`, then STOP and ask your user which page they mean. Never pick one yourself. `get_advertiser_ads` takes page ids only.
- Every response starts with `next`. Read it first and follow it. A result that starts with PARTIAL RESULT is incomplete: say so.
- If you get `approval_required`, tell your user the price and ask. Only then call again with `approved: true`.
- Read `extra-compact` first, then `full` for the few ads you need. Re-reading a job is free for 90 days.
- `country` is where an ad was shown, not where the advertiser is based.
- Setup: run `npx adsentinel login` (your user approves once in a browser), then use the MCP server `npx -y adsentinel mcp` or the `adsentinel` CLI. Without a key every tool returns `no_api_key` with the sign-up link.

## Docs

- [Quickstart](https://adsentinel.eu/docs/quickstart.md): sign in, connect, first question
- [Tools](https://adsentinel.eu/docs/tools.md): the seven tools, parameters and errors, generated from the schema
- [Pricing](https://adsentinel.eu/pricing.md): pay as you go or Pro, what is never charged, spend limits

## Optional

- [Terms](https://adsentinel.eu/terms.md)
- [Refunds](https://adsentinel.eu/refunds.md)
- [Privacy](https://adsentinel.eu/privacy.md)
- [Acceptable use](https://adsentinel.eu/acceptable-use.md)
- [Status](https://adsentinel.eu/status): JSON for agents

Data comes from Meta's public Ad Library, read as a logged-out visitor when you ask. AdSentinel is not affiliated with, endorsed by or sponsored by Meta Platforms, Inc.