Adyntel MCP server
11 operations0 webhooks
Ad intelligence across Meta, Google, LinkedIn and TikTok - ad libraries, keyword searches, paid versus organic keywords.
Try Adyntel with your agent
Connect Adyntel, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Adyntel on my account, then run one read-only example and show me the result.
Adyntel tools and triggers
Tools are what your agent can do in Adyntel through Corsair's MCP server. Triggers are the Adyntel events a routine can start from.
- AdsRead-only
List a company's Google ads from Google's Ad Transparency report by domain, filtered by media type and country, with a continuation token per page
google.ads
- ShoppingRead-only
Start a Google Shopping ad lookup for a domain: synchronous ads when `shopping` is true, otherwise a task ID to poll with `google.shoppingStatus`
google.shopping
- Shopping StatusRead-only
Read the ads of a Google Shopping lookup started by `google.shopping`; free, and the only way to collect an async task
google.shoppingStatus
Tiktok
- Ad DetailsRead-only
Read one TikTok ad in full, including its advertiser and its targeting, from an ad ID returned by `tiktok.keywordSearch`
tiktok.adDetails
- AdsRead-only
List a company's TikTok ads by domain, optionally including the influencers posting sponsored content for the brand, with continuation tokens
tiktok.ads
- Keyword SearchRead-only
Search the TikTok ad library for a keyword, limited to European countries or worldwide. Returns the first page only: the API exposes no paging parameter, so `search_id` and `has_more` are informational and a later page cannot be requested
tiktok.keywordSearch
- AdsRead-only
List a company's LinkedIn ads by domain or page ID, with optional date filtering, EU impression data and creative text extraction, each of which costs an extra credit
linkedin.ads
- Keyword SearchRead-only
Search the LinkedIn Ad Library for a keyword, filtered by country and date range, with a continuation token per page
linkedin.keywordSearch
Meta
- Ad SearchRead-only
Search the whole Meta ad library for a keyword, optionally limited to one country, with a continuation token per page
meta.adSearch
- AdsRead-only
List a company's Facebook and Instagram ads from Meta's Ad Library, by Facebook page or domain, with country, language, media-type and ad-category filters and a continuation token per page
meta.ads
Keywords
- Paid Vs OrganicRead-only
Read paid and organic keyword counts for a domain, with position breakdowns, estimated traffic, ad budget and average CPC
keywords.paidVsOrganic
Connect Adyntel to Claude, ChatGPT or Cursor
- 1
Connect Adyntel in Corsair
Add your Adyntel API key once in Corsair. Corsair stores the credential encrypted and makes the Adyntel API calls for your agent, so it never goes into a prompt or a config file. Connect Adyntel
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Adyntel. On a ChatGPT personal plan, connect Adyntel here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. Every Adyntel operation only reads data, so it runs right away in every mode.
FAQ
Install corsair and @corsair-dev/adyntel, add the Adyntel plugin, and connect with an API key. Then call methods like corsair.adyntel.api.google.ads() from your app. Corsair keeps each tenant isolated.
Yes. Adyntel requires an API key from your Adyntel account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Adyntel, GitHub, Notion, Stripe, and the rest. Trigger Adyntel from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for ad intelligence across Meta, Google, LinkedIn and TikTok - ad libraries, keyword searches, paid versus organic keywords. Common builds include sync jobs, admin tooling, and agents that call Adyntel APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Adyntel API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/adyntel in the open repo. When Adyntel ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Adyntel data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Adyntel data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Adyntel on a link in Strict mode and every write waits for your approval, while destructive actions are refused. Every Adyntel operation only reads data, so there are no changes to approve today. You can change a link's mode at hub.corsair.dev/me.