creatives_list
Retrieve a paginated list of all creatives in an Apple Ads account. Use limit and offset to manage result size.
Instructions
List all creatives in the org (paginated).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max items per page. Apple's hard cap is 1000 for most endpoints. | |
| offset | No | Result offset for pagination. | |
| orgId | No | Override the org (account) for this call. Defaults to ASA_ORG_ID. Use the `org_acls` tool to discover orgIds. |
Implementation Reference
- src/tools/creatives.ts:59-66 (handler)Handler function for creatives_list tool. Sends a GET request to /creatives with limit/offset pagination and returns unwrapped response.
handler: async ({ limit, offset, orgId }, { client }) => { const res = await client.request({ path: "/creatives", query: { limit, offset }, orgId, }); return unwrap(res); }, - src/tools/creatives.ts:54-58 (schema)Input schema for creatives_list: accepts limit, offset (pagination), and orgId (optional override).
inputShape: { limit: limitField, offset: offsetField, orgId: orgIdField, }, - src/tools/creatives.ts:51-52 (registration)Tool definition registering creatives_list with name, description, input schema, and handler in the creativeTools array.
{ name: "creatives_list", - src/tools/index.ts:22-22 (registration)creativeTools is spread into the allTools array, making creatives_list available to the MCP server.
...creativeTools, - src/index.ts:39-40 (registration)Main MCP server registration loop that registers all tools (including creatives_list) via server.registerTool.
server.registerTool( tool.name,