# Adform Geo Reference

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-adform-agentic-skills-adform-geo-reference`
- **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-geo-reference
- **Website:** https://site.adform.com

## Install

```sh
agentstack add skill-adform-agentic-skills-adform-geo-reference
```

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

## About

# Adform geo reference, currency, and labels

Search geo targeting reference data, look up currency exchange rates, and list label taxonomy.
Read-only.

## Connection & tooling

Runs on the Adform GraphQL MCP. Use `graphql_execute` to run queries. Keep calls sequential
(~1–2s apart).

---

## Geo targeting reference

The geo hierarchy is: Continent → Country → Region → City. Use the returned `id` values in
line-item geo targeting rules.

### Search countries

```graphql
{ countries(search: "Germany", offset: 0, limit: 10) { countries { id name iso2Code iso3Code continentId } totalCount } }
```

### Search regions

```graphql
{ regions(countryId: "276", offset: 0, limit: 20) { regions { id name countryId } totalCount } }
```

### Search cities

```graphql
{ cities(countryId: "276", search: "Berlin", offset: 0, limit: 20) { cities { id name regionId countryId } totalCount } }
```

---

## Currency rates

CurrencyCode is ISO 4217: `EUR`, `USD`, `DKK`, `GBP`, `SEK`, `NOK`, etc.
Always pass currency codes as quoted strings (e.g. `"EUR"`, not `EUR`).

```graphql
{ currencyRate(sourceCurrencyCode: "EUR", targetCurrencyCode: "USD") { sourceCurrencyCode targetCurrencyCode rate } }
```

---

## Label taxonomy

Labels are scoped per advertiser or campaign — there is no global `labelGroups` query.

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

```graphql
{ campaignLabels(id: "3993873") { labelGroups { id name labels { id name } } } }
```

Label group IDs are used in campaign, advertiser, and line-item label queries.

---

## Common workflows

- **Geo targeting setup**: search countries → search regions by `countryId` → search cities by
  `regionId` → use IDs in line-item geo targeting rules
- **Currency conversion**: get currency rate for cross-currency budget comparisons
- **Label resolution**: list label groups to map label IDs from campaigns and line items to names

## 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-geo-reference
- 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%.