MMetadata /docs
⌘K
Docs/Tools/get_offer

get_offer

Get offer information by name or list all offers.

Read campaigns

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Get offer information by name or list all offers.

USE FOR: "Show me the [offer name] offer", "What's in [offer name]?", "Find offer called [name]", "List all offers"

If name provided: returns detailed offer info (name, description, assets, configuration).
If no name: returns list of all available offers.

Arguments

ArgumentTypeNotes
name string The name of the offer to search for. Example: 'AI Marketing Audit Demo'. If omitted, returns a list of all available offers.
offer_id integer Exact offer id. PREFER THIS over `name` whenever you have an id: a name lookup returns the first search match, so offers sharing a prefix (a template name plus a random suffix, which is how offers get named here) can resolve to the wrong one silently. Takes precedence when both are given.

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_offer","arguments":{}}}'

Response

Real, from the production server, in 442 ms. The full response was 11,721 bytes; this is the first part of it. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "totalElements": "[number redacted]",
 "totalPages": 51,
 "data": [
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "PROGRAMMATIC",
   "goal": "CPL",
   "type": "LP",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": false,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:20:16.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "PROGRAMMATIC",
   "goal": "CPL",
   "type": "LP",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": false,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:20:16.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "FACEBOOK",
   "goal": "CPL",
   "type": "LG",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": null,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:16:32.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "FACEBOOK",
   "goal": "CPL",
   "type": "LG",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": null,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:16:31.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "LINKEDIN",
   "goal": "CPL",
   "type": "LG",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": null,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:16:30.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "MICROSOFT_ADS",
   "goal": "CPL",
   "type": "LG",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": null,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:16:30.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "MICROSOFT_ADS",
   "goal": "CPL",
   "type": "LG",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": null,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:16:30.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "LINKEDIN",
   "goal": "CPL",
   "type": "LG",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": null,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T22:16:30.000Z",
   "accountId": "[number redacted]"
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "PROGRAMMATIC",
   "goal": "CPL",
   "type": "LP",
   "status": true,
   "visibility": null,
   "completionStatus": "COMPLETED",
   "latestLeadDate": null,
   "latestTestLeadSuccessful": false,
   "tags": [],
   "renameAllowed": false,
   "account_id": "[number redacted]",
   "created_date": "2026-09-03T20:46:29.000Z",
   "accountId": "[number redac
  … truncated

Other campaigns tools:

All 160 tools · machine-readable index