mcpField
C
cloudflare-agents

cloudflare-agents

github.com/secondskyAgent workflows240382 installsUpdated 5w ago
Repository

About cloudflare-agents

A skill guide for building agents on Cloudflare, aimed at developers working with LLM-based applications. It covers tool registration, provider options, Cloudflare bindings, MCP integration, and reusable implementation templates.

Key features

  1. 01Register and execute tools
  2. 02OpenAI, Anthropic, and Gemini providers
  3. 03Cloudflare D1, KV, R2, and Durable Objects
  4. 04HTTP, SSE, and WebSocket patterns
  5. 05State management and scheduled tasks
  6. 06Agent and MCP integration templates

Use cases

  1. 01Build an agent that calls registered tools
  2. 02Connect an agent to Cloudflare storage bindings
  3. 03Implement streaming or WebSocket agent interfaces
  4. 04Add MCP integration to a Cloudflare agent

MCP support

The guide includes MCP protocol support, an MCP integration reference, and a template for integrating an MCP server with an agent.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/secondsky/claude-skills --skill cloudflare-agents

After installing, type/cloudflare-agentsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
advanced-features.md
agent-api.md
configuration-guide.md
error-catalog.md
http-sse-guide.md
mcp-integration.md
patterns-concepts.md
state-management.md
websockets-guide.md
templates/
basic-agent.ts
browser-agent.ts
calling-agents-worker.ts
chat-agent-streaming.ts
hitl-agent.ts
mcp-server-basic.ts
rag-agent.ts
react-useagent-client.tsx
scheduled-agent.ts
state-sync-agent.ts
websocket-agent.ts
workflow-agent.ts
wrangler-agents-config.jsonc

Details

From the project README

Cloudflare Agents

Last Updated: 2025-11-21

Quick Start

export default {
  async fetch(request, env, ctx) {
    const agent = {
      tools: [
        { name: 'getTodo', handler: async ({id}) => ({id, title: 'Task'}) }
      ],
      async run(input) {
        return await processWithLLM(input, this.tools);
      }
    };
    
    return Response.json(await agent.run(await request.text()));
  }
};

Core Features

  • Tool Integration: Register and execute tools
  • LLM Providers: OpenAI, Anthropic, Google Gemini
  • MCP Protocol: Model Context Protocol support
  • Cloudflare Bindings: D1, KV, R2, Durable Objects

Agent Pattern

const agent = {
  tools: [...],
  systemPrompt: 'You are a helpful assistant',
  model: 'gpt-4o',
  async run(input) {
    // Process with LLM
  }
};

Resources

Core Documentation
  • references/patterns-concepts.md (317 lines) - What is Cloudflare Agents, patterns & concepts, critical rules, known issues prevention
  • references/configuration-guide.md (152 lines) - Complete configuration deep dive
  • references/agent-api.md (115 lines) - Complete Agent Class API reference
Integration Guides
  • references/http-sse-guide.md (74 lines) - HTTP & Server-Sent Events
  • references/websockets-guide.md (110 lines) - WebSocket integration
  • references/state-management.md (388 lines) - State management, scheduled tasks, workflows
  • references/mcp-integration.md (130 lines) - Model Context Protocol integration
Advanced Features
  • references/advanced-features.md (637 lines) - Browser automation, RAG, AI model integration, calling agents, client APIs
Error Reference
  • references/error-catalog.md (10 lines) - Common errors and solutions
Templates
  • templates/basic-agent.ts - Basic agent setup
  • templates/browser-agent.ts - Browser automation
  • templates/calling-agents-worker.ts - Calling other agents
  • templates/chat-agent-streaming.ts - Streaming chat agent
  • templates/hitl-agent.ts - Human-in-the-loop
  • templates/mcp-server-basic.ts - MCP server integration
  • templates/rag-agent.ts - RAG implementation
  • templates/react-useagent-client.tsx - React client integration
  • templates/scheduled-agent.ts - Scheduled tasks
  • templates/state-sync-agent.ts - State synchronization
  • templates/websocket-agent.ts - WebSocket agent
  • templates/workflow-agent.ts - Workflows integration
  • templates/wrangler-agents-config.jsonc - Wrangler configuration

Official Docs: https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-agents/

Comments

Markdown supported