Skip to main content

Building an AI startup?

You might be eligible for our Startup Program. Get fully funded access to the infrastructure you’re reading about right now (up to $50K value).

​
Hosted MCP

1

Get your API token

  1. Go to Bright Data user settings
  2. Copy your API token (it looks like: 2dceb1aa0***************************)
2

Set up your Cloudflare environment

Make sure you have Node.js 20+ installed, then log in to Cloudflare:
npx wrangler login
3

Install the Agents Starter template

npx create-cloudflare@latest mcp-demo --template cloudflare/agents-starter
cd mcp-example
npm install
4

Configure environment variables

Copy the example env file and add your OpenAI API key:
cp .dev.vars.example .dev.vars
Edit .dev.vars:
OPENAI_API_KEY=sk-...
5

Connect Bright Data MCP in your agent

In src/server.ts, find the default commented MCP placeholder inside onChatMessage:
// const mcpConnection = await this.mcp.connect(
//   "https://path-to-mcp-server/sse"
// );
Replace it with the Bright Data MCP connection:
// Connect to Bright Data MCP server
const mcpConnection = await this.mcp.connect(
  "https://mcp.brightdata.com/mcp?token=<API_TOKEN>"
);

// Merge MCP tools with local tools
const allTools = {
  ...tools,
  ...this.mcp.getAITools()
};
Make sure mcp.connect() is called before this.mcp.getAITools() to avoid jsonSchema not initialized errors.
6

Test it works

  1. Replace <API_TOKEN> with your actual Bright Data API token
  2. Start the development server:
npm start
  1. Open the app in your browser and ask the agent a question, for example:
Find the latest 3 news items about Cloudflare Agents and summarize them in bullets with links.
You should see the agent use Bright Data’s web scraping tools to fetch and summarize live results:Screenshot 2026 02 10 At 11 10 50
7

Monitor usage

  1. View your API usage at My Zones in your Bright Data dashboard
  2. Your free tier includes 5,000 requests per month