# Adform Entity Browsing

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-adform-agentic-skills-adform-entity-browsing`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [adform](https://agentstack.voostack.com/s/adform)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [adform](https://github.com/adform)
- **Source:** https://github.com/adform/agentic-skills/tree/main/dist/generic/adform-entity-browsing
- **Website:** https://site.adform.com

## Install

```sh
agentstack add skill-adform-agentic-skills-adform-entity-browsing
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Adform entity browsing and ID resolution

Find, list, and resolve Adform entities — advertisers, campaigns, orders, line items — by name
or ID. Browse the full hierarchy with delivery indications, or do quick name-to-ID lookups.
Read-only.

## Connection & tooling

Runs on the Adform GraphQL MCP. Use `graphql_execute(query, variables)` to run and
`graphql_validate` to check a query first. Always validate before executing. The queries below are
**illustrative examples** — if a field or input shape isn't shown, or a query fails validation,
discover the current schema with `graphql_search` (lighter, preferred) and fall back to
`graphql_introspect` one call at a time with ≥2s between calls for complex input types, enum
values, or union/interface resolution.

---

## 1. Name-to-ID lookup

Convert an entity name to its numeric ID using `agencyListItems` with a search filter. Set the
filter fieldName to the entity type and property you want to match.

```graphql
{
  agencyListItems(
    filters: [{ fieldName: "advertiser.name", operation: eq, values: ["Acme Corp"] }]
  ) {
    advertisers { id name }
  }
}
```

Reverse lookup — ID to name:

```graphql
{
  agencyListItems(
    filters: [{ fieldName: "campaign.id", operation: in, values: ["123456", "789012"] }]
  ) {
    campaigns { id name }
  }
}
```

---

## 2. Hierarchy browser — campaigns by advertiser

```graphql
{
  agencyListItems(
    filters: [{ fieldName: "advertiser.id", operation: eq, values: ["71883"] }]
    pagination: { limit: 20, offset: 0 }
  ) {
    campaigns {
      id name status
      period { start end }
      createdAt billingCode currencyCode type subType
    }
  }
}
```

## 3. Hierarchy browser — line items by order

```graphql
{
  agencyListItems(
    filters: [{ fieldName: "order.id", operation: eq, values: ["456789"] }]
    pagination: { limit: 20, offset: 0 }
  ) {
    lineItems {
      id name type status buyingType channelTypes
      rtbSettings { environments buying { type price maxBidPrice } }
    }
  }
}
```

---

## 4. List advertisers

```graphql
{
  advertisers(
    status: active
    offset: 0
    limit: 20
  ) {
    advertisers { id name status type }
    totalCount
  }
}
```

## 5. Get advertiser detail

```graphql
{
  advertiser(id: "71883") {
    id name status type
    industryVerticalId timeZoneMappingId
    trackingDomain netAmountCalcMethod
  }
}
```

## 6. Get advertiser labels

```graphql
{ advertiserLabels(id: "71883") { labelGroups { id name labels { id name } } } }
```

## 7. Get RTB domain settings

```graphql
{ rtbDomains(id: "71883") { mode domains } }
```

---

## Common patterns

- **Name to ID**: `agencyListItems` with a `searchPhrase` contains filter for the entity level
- **Hierarchy drill-down**: list advertisers → campaigns by advertiser → orders by campaign →
  line items by order
- **ID format**: advertiser, campaign, order, and line item IDs are numeric strings

## Presenting

Show entity name and ID, status, and relevant config fields. For hierarchy views, render as an
indented tree or table. Always include the numeric ID so the trader can cross-reference in the
Adform platform.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [adform](https://github.com/adform)
- **Source:** [adform/agentic-skills](https://github.com/adform/agentic-skills)
- **License:** MIT
- **Homepage:** https://site.adform.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-adform-agentic-skills-adform-entity-browsing
- Seller: https://agentstack.voostack.com/s/adform
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.