# Adyntel — how to use (mcp.ai)

Connect your Adyntel account and use 8 tools for ads and conversion straight from your AI agent. Connect with your own API key. Adyntel provides an API to retrieve LinkedIn ads for a given company using the company's domain or LinkedIn Page ID.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_adyntel?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `adyntel_get_google_ads_by_company`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/adyntel`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/adyntel/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/adyntel/get/google/ads/by/company` — Retrieve Google ads for a company domain. Returns ad creatives including text, image, and video ads with advertiser information. Response includes a `total_ad_count` field that typically exceeds the c
  - body: { media_type?: string, company_domain: string }
- `POST https://api.mcp.ai/api/adyntel/get/google/shopping/search/status` — Check the status and retrieve results of a Google Shopping ads search. Use the ID returned from the google_shopping endpoint. No credits charged for status checks.
  - body: { id: string }
- `POST https://api.mcp.ai/api/adyntel/get/linked/in/ads/by/company` — Retrieve LinkedIn ads for a company by domain or LinkedIn page ID. Returns ad creatives and campaign details.
  - body: { company_domain?: string, linkedin_page_id?: integer }
- `POST https://api.mcp.ai/api/adyntel/get/meta/ads/by/company/or/page` — Retrieve Meta/Facebook ads for a company domain or Facebook page URL. Returns ad creatives, engagement metrics, and campaign details.
  - body: { media_type?: string, webhook_url?: string, country_code?: string, facebook_url?: string, active_status?: string, company_domain?: string, continuation_token?: string }
- `POST https://api.mcp.ai/api/adyntel/get/paid/vs/organic/keywords` — Analyze paid vs organic keyword performance for a company domain. Returns keyword data comparing paid advertising and organic search performance.
  - body: { company_domain: string }
- `POST https://api.mcp.ai/api/adyntel/meta/ad/search` — Search the Meta ad library.
  - body: { keyword: string, country_code?: string, continuation_token?: string }
- `POST https://api.mcp.ai/api/adyntel/search/tik/tok/ads/by/keyword` — Search the TikTok ad library using keywords. Returns matching ads with creative content, engagement metrics, and targeting information.
  - body: { keyword: string, country_code?: string }
- `POST https://api.mcp.ai/api/adyntel/start/google/shopping/search` — Start an asynchronous Google Shopping ads search for a company domain. Returns a job ID to check status with the google_shopping_status endpoint.
  - body: { company_domain: string }

## Example prompts
- "What can I do in Adyntel?"
- "Show me a summary of my Adyntel account"

## More
- Page: https://mcp.ai/adyntel
- Agent spec (llms.txt): https://mcp.ai/adyntel/llms.txt
- Postman collection: https://mcp.ai/adyntel/postman.json