[ Docs ]

BanglaRadar for AI agents

Last updated 29 September 2026

BanglaRadar runs a Model Context Protocol (MCP) server, so AI assistants like Claude and ChatGPT, and coding agents like Cursor and Claude Code, can search Bangladesh's Facebook and Instagram ads and research the businesses behind them for you — with your account, within your plan. Server URL: https://banglaradar.com/mcp

1. What your agent can do

Ask in plain words — “which honey sellers have been running the same ad for 60+ days?” — and the agent uses these tools:

  • search_ads — Search Bangladeshi Facebook and Instagram ads by words, advertiser, format, call to action, destination, places mentioned, launch date and run length
  • get_ad — One ad in full: copy, creatives, dates, landing page with the website's age and shop platform, and the advertiser's contacts
  • get_ad_versions — Every relaunch of an ad's copy — how an advertiser scales a winner
  • search_advertisers — Find advertisers by name, category, website, size and recent activity
  • get_advertiser — A business's advertising profile: websites, contacts, launch pace, formats and best ads
  • get_advertiser_ads — An advertiser's newest, longest-running or most-scaled ads
  • get_advertiser_copy — The ad texts and headlines an advertiser keeps paying for
  • get_advertiser_timeline — Ads running, launched and stopped per day, up to 90 days
  • get_website — A landing website's age, registrar, shop platform, payments and the advertisers using it
  • get_account — Your plan and what is left of it this month and today
  • list_saved_ads — Your saved ads
  • list_tracked_pages — The advertisers in your page tracker
  • save_ad — Save or unsave an ad (needs write access)
  • track_page — Track or untrack an advertiser for alerts (needs write access)

It also offers two ready-made prompts: competitor report and niche research.

2. Which plans include it

  • Starter: 200 tool calls a day
  • Growth: 1,000 tool calls a day
  • Agency: 5,000 tool calls a day

Searches an agent runs count against your monthly search quota, exactly like searches on the website. See plans.

3. Connect your app

Apps that support sign-in connect with OAuth: you log in to BanglaRadar once, approve the app, and can disconnect it any time in Settings › AI agents. No key to copy.

Claude

  1. In Claude (claude.ai or the desktop app), open Settings › Connectors.
  2. Choose Add custom connector. Name it BanglaRadar and paste the server URL.
  3. Click Connect, log in to BanglaRadar and approve. Then turn the connector on in a chat.

ChatGPT

  1. In ChatGPT, open Settings › Apps & Connectors › Advanced and switch on Developer mode.
  2. Create a connector named BanglaRadar with the server URL, and choose OAuth for authentication.
  3. Log in to BanglaRadar when asked and approve. Add the connector to a chat from the + menu.

Claude Code

  1. Add the server from your terminal, then run /mcp inside Claude Code to log in.
claude mcp add --transport http banglaradar https://banglaradar.com/mcp

Cursor

  1. Add BanglaRadar to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
  2. Cursor asks you to log in the first time it uses a tool.
{
  "mcpServers": {
    "banglaradar": { "url": "https://banglaradar.com/mcp" }
  }
}

VS Code

  1. Add BanglaRadar to .vscode/mcp.json, then start it from the MCP servers list.
  2. Use it from Copilot Chat in agent mode; VS Code opens the log-in page once.
{
  "servers": {
    "banglaradar": { "type": "http", "url": "https://banglaradar.com/mcp" }
  }
}

Gemini CLI

  1. Add BanglaRadar to ~/.gemini/settings.json, then run /mcp auth banglaradar in Gemini CLI.
{
  "mcpServers": {
    "banglaradar": { "httpUrl": "https://banglaradar.com/mcp" }
  }
}

Windsurf

  1. Add BanglaRadar to ~/.codeium/windsurf/mcp_config.json and refresh the MCP servers list.
{
  "mcpServers": {
    "banglaradar": { "serverUrl": "https://banglaradar.com/mcp" }
  }
}

Other agents

  1. Any MCP client that speaks Streamable HTTP works. Apps that support OAuth sign in on their own.
  2. For scripts, automations (n8n, Make) and agents without OAuth, create an API key below and send it as a bearer token.
Authorization: Bearer brk_…your key…

4. API keys

For scripts, automations and agents that can't sign in, create a key in Settings › AI agents and send it as a bearer token to the server URL over Streamable HTTP:

Authorization: Bearer brk_…

A key acts as you. It can be read-only or read-and-write, can expire, and is shown only once; we keep a hash, never the key. Revoke it the moment it leaks.

5. Security and privacy

  • OAuth 2.1 with PKCE for every app. Access tokens last an hour and are bound to this server alone; a token issued for anything else is refused here, and ours are refused everywhere else.
  • Apps identify themselves with a Client ID Metadata Document, or register dynamically; the consent screen names the app and the domain that vouches for it. Approve only apps you trust.
  • An agent gets read access unless you grant write access (saving ads, tracking pages), which it must ask for separately.
  • Disconnecting an app or revoking a key takes effect within 30 seconds.
  • Agents see only what you see on the website: the same plan limits and the same hidden advertisers.
  • Ad text is written by advertisers. Agents are told to treat it as data and never as instructions — keep an eye on what yours does with it.

6. Troubleshooting

  • “AI agents are not included in your plan” — upgrade in Settings › Billing, then reconnect.
  • Daily limit reached — the allowance resets at 00:00 UTC.
  • The app keeps asking to log in — disconnect it in Settings › AI agents and connect again.
  • Opening the URL in a browser brings you to this page: the server itself only answers MCP requests (POST).