API Reference

Meta Ads / API Reference

meta_ads_render_report_pdf

Meta Ads tool. Generate a universal PDF report from any structured data. Pass data from ANY source (Google Ads, Meta, Analytics, GA4, etc.) and get a beautiful dark-themed PDF saved to disk. Args: title: Report title (e.g. "Google Ads Weekly Report"). metrics: JSON list of KPI objects: [{"label":"Spend","value":"$1,234","color":"#7c3aed"}, ...] color is optional (defaults cycle through palette). table_headers: JSON list of column names: ["Campaign","Spend","Clicks"] table_rows: JSON list of rows (list of lists): [["Campaign A","$500","1,200"],["Campaign B","$300","800"]] time_series: JSON object with optional line chart data: {"labels":["01/01","02/01",...], "series":[{"name":"Spend","values":[100,200,...],"color":"#7c3aed"}, {"name":"Clicks","values":[50,80,...],"color":"#06b6d4","secondary":true}]} subtitle: Optional date range or description shown under the title. output_path: Where to save the PDF. Defaults to ~/Desktop/<title>_YYYYMMDD.pdf

This is a read-only tool: it returns render report pdf 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:

Render report pdf in my Meta Ads account for [title].

It takes 1 required and 6 optional parameters.

Parameters

ParameterTypeRequiredDescription
titlestringYesTitle
metricsstringNoMetrics
table_headersstringNoTable Headers
table_rowsstringNoTable Rows
time_seriesstringNoTime Series
subtitlestringNoSubtitle
output_pathstringNoOutput Path

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