API Reference

Meta Ads / API Reference

meta_ads_image_pipeline

Meta Ads tool. Upload an image from a public URL to the Meta image library and return image_hash. Downloads the image bytes and uploads as multipart/form-data (works even without Advanced API Access). Use this as step 2 of the image pipeline: Step 1: Generate image externally (Gemini / Nano Banana / any tool) → get public URL Step 2: Call this tool with the URL → get image_hash ready for ad creatives Args: image_url: Public URL to the JPG/PNG/GIF image to upload (required). account_id: Ad account ID. Leave blank to use META_AD_ACCOUNT_ID from .env.

This is a read-only tool: it returns image pipeline for your Meta Ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Image pipeline in my Meta Ads account for [image url].

It takes 1 required and 1 optional parameter.

Parameters

ParameterTypeRequiredDescription
image_urlstringYesImage Url
account_idstringNoAccount Id

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads