Cloudflare Agents SDK integration

How to integrate Cloudflare’s Agents SDK with Bright Data’s Web MCP server for building AI agents on Cloudflare Workers. Exposes 60+ MCP tools.

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 $20K value).

Learn more

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-out MCP connection 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
   

   3. 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:

   
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