Toolcape · Meta Ads

Toolcape + Meta Ads

Toolcape connects a company’s existing AI to its systems through one MCP entry point, with account connections, group and individual permissions, and audit logs. This documentation describes a product prototype; it is not evidence that a live server or account is connected.

The connection

Meta Ads: Advertising management and reports for Meta advertising accounts.
API connection · AI uses Toolcape through MCP
Provider sign-in (OAuth). Confirm whether the configured connection acts as the user or uses application permissions.

Typical actions

- Read: Read advertising results
- Create: Create supported campaign resources
- Change: Change supported advertising settings
This source is Meta Ads, not general access to Facebook or Instagram messages. Confirm the intended advertising account.

Setup

1. IT configures the provider app, API and requested scopes.
2. Provider sign-in (OAuth). Confirm whether the configured connection acts as the user or uses application permissions.
3. Make the service available in Toolcape. Set Everyone, group and individual rules for the actions actually needed. Adding a service does not grant access.
4. Connect the approved AI client to the actual Toolcape MCP address and sign in. Start with a harmless read-only task and check the audit log.

Permissions

For personal delegated access, the provider account, approved app scopes and Toolcape rules must all permit the action. Shared accounts and application permissions may have other limits. Toolcape combines Everyone and group grants; a personal exception replaces inherited access for that service. Reading can disclose confidential information. Sharing, sending and deletion need separate consideration.

Calling an operation

First discover which tools the connected Toolcape server actually exposes. If it offers search → describe → execute, find the relevant operation, inspect its input schema and permissions, then call it with validated inputs. Tool names vary by server; do not invent names, arguments, URLs or successful outcomes. Without connected tools, give setup guidance instead of claiming to perform actions.

Operation reference

Catalog snapshot: 16 September 2026. Verify the current schema before calling.
- adsAccountGetActivityLogs — Get Account Activity Logs
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsActivateEntity — Activate Entity
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsBoostIgPost — Boost Ig Post
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogCreate — Create Catalog
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogCreateFeedRule — Create Catalog Feed Rule
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogCreateProductFeed — Create Catalog Product Feed
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogCreateProductFeedUploadSession — Create Catalog Product Feed Upload Session
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogCreateProductSet — Create Catalog Product Set
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogDeleteProduct — Delete Catalog Product
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogEventSourceConnect — Catalog Event Source Connect
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogEventSourceDisconnect — Catalog Event Source Disconnect
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogEventSourceGet — Get Catalog Event Source
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogEventSourceGetCatalogs — Get Catalog Event Source Catalogs
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogEventSourceGetHealth — Get Catalog Event Source Health
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogEventSourceGetRecommendations — Get Catalog Event Source Recommendations
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogGetBusinesses — Get Catalog Businesses
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogGetDataSources — Get Catalog Data Sources
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogGetDiagnostics — Get Catalog Diagnostics
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogGetDynamicAdsHealth — Get Catalog Dynamic Ads Health
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogGetFeedRules — Get Catalog Feed Rules
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogGetProductFeedUploadSessions — Get Catalog Product Feed Upload Sessions
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogListCatalogs — List Catalog Catalogs
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogListPartnerIntegrations — List Catalog Partner Integrations
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogListProductFeeds — List Catalog Product Feeds
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogListProductSets — List Catalog Product Sets
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogListProducts — List Catalog Products
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogProductCreate — Create Catalog Product
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogProductFeedDelete — Delete Catalog Product Feed
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogProductFeedDeleteRule — Delete Catalog Product Feed Rule
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogProductSetDelete — Set Catalog Product Delete
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogUpdateCatalog — Update Catalog Catalog
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogUpdateProduct — Update Catalog Product
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogUpdateProductFeed — Update Catalog Product Feed
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCatalogUpdateProductSet — Update Catalog Product Set
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreateAd — Create Ad
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreateAdSet — Create Ad Set
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreateCampaign — Create Campaign
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreateCreative — Create Creative
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreateCustomAudience — Create Custom Audience
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreativeDelete — Delete Creative
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreativeUpdate — Update Creative
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreativeUploadImage — Creative Upload Image
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreativeUploadLocalImage — Creative Upload Local Image
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreativeUploadMedia — Creative Upload Media
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsCreativeUploadVideo — Creative Upload Video
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsDeleteCustomAudience — Delete Custom Audience
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsDeleteLocalAdImage — Delete Local Ad Image
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsExperimentAbtestCreateTest — Create Experiment Abtest Test
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsExperimentAbtestGetTest — Get Experiment Abtest Test
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsExperimentAbtestUpdateTest — Update Experiment Abtest Test
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsExperimentCheckEligibility — Experiment Check Eligibility
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsExperimentLiftCreateTest — Create Experiment Lift Test
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsExperimentLiftGetTest — Get Experiment Lift Test
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsExperimentListTests — List Experiment Tests
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsFinalizeLocalAdImageUpload — Finalize Local Ad Image Upload
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetAdAccountCustomAudiences — Get Ad Account Custom Audiences
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetAdAccountPages — Get Ad Account Pages
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetAdAccounts — Get Ad Accounts
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetAdEntities — Get Ad Entities
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetAdImages — Get Ad Images
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetAdPreview — Get Ad Preview
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetAdVideos — Get Ad Videos
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetCreativeAds — Get Creative Ads
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetCreatives — Get Creatives
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetCustomAudience — Get Custom Audience
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetCustomAudienceAdsets — Get Custom Audience Adsets
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetCustomconversions — Get Customconversions
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetDatasetDetails — Get Dataset Details
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetDatasetQuality — Get Dataset Quality
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetDatasetStats — Get Dataset Stats
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetDatasets — Get Datasets
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetErrors — Get Errors
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetFieldContext — Get Field Context
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetHelpArticle — Get Help Article
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetIgAccounts — Get Ig Accounts
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetIgMedia — Get Ig Media
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetOpportunityScore — Get Opportunity Score
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetPagesForBusiness — Get Pages For Business
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsGetUserPages — Get User Pages
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsInsightsAdvertiserContext — Insights Advertiser Context
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsInsightsAnomalySignal — Insights Anomaly Signal
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsInsightsAuctionRankingBenchmarks — Insights Auction Ranking Benchmarks
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsInsightsIndustryBenchmark — Insights Industry Benchmark
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsInsightsPerformanceTrend — Insights Performance Trend
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsLibrarySearch — Search Library
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsLogUiInteraction — Log Ui Interaction
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelEventCreate — Create Pixel Event
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelEventDelete — Delete Pixel Event
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelEventRead — Pixel Event Read
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelEventUpdate — Update Pixel Event
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelParameterCreate — Create Pixel Parameter
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelParameterDelete — Delete Pixel Parameter
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelParameterRead — Pixel Parameter Read
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsPixelParameterUpdate — Update Pixel Parameter
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsUpdateCustomAudience — Update Custom Audience
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsUpdateCustomAudienceUsers — Update Custom Audience Users
MCP
https://developers.facebook.com/docs/marketing-apis/
- adsUpdateEntity — Update Entity
MCP
https://developers.facebook.com/docs/marketing-apis/

A useful first question

Summarize our campaign results for the last seven days.

If it fails

Check the account, expired authorization, app approval, provider scopes and Toolcape permissions. Share only redacted errors with support. Never paste passwords, tokens or client secrets into an AI conversation.

Markdown