Connect the built-in MCP server to your agent to get context on Epic Web workshop material and steer coding agents
epic-agent provides an MCP server and a Remix-powered UI on Cloudflare Workers. It allows you to connect the MCP server to your agent (like ChatGPT or coding agents) to get context on workshop material and review things. This is useful for evaluating technical decisions, solidifying your understanding, and steering coding agents to follow the practices taught in the workshops.
A feature that's coming soon is a built-in chat page that will allow you to chat directly with an LLM that has access to the built-in MCP server.
See docs/getting-started.md for the full setup
paths and expectations.
| Layer | Technology |
|---|---|
| Runtime | Cloudflare Workers |
| UI Framework | Remix 3 (alpha) |
| Package Manager | Bun |
| Database | Cloudflare D1 |
| Session/OAuth | Cloudflare KV |
| MCP State | Durable Objects |
| E2E Testing | Playwright |
| Bundler | esbuild |
Request → worker/index.ts
│
├─→ OAuth handlers
├─→ MCP endpoints
├─→ Static assets (public/)
└─→ Server router → Remix components
worker/index.tsis the entrypoint for Cloudflare Workers- OAuth requests are handled first, then MCP requests, then static assets
- Non-asset requests fall through to the server handler and router
- Client assets are bundled into
public/and served via theASSETSbinding
| Document | Description |
|---|---|
docs/getting-started.md |
Setup, environment variables, deploy |
docs/environment-variables.md |
Adding new env vars |
docs/agents/setup.md |
Local development and verification |
docs/architecture/mcp-retrieval-tools.md |
MCP workshop retrieval and indexing flow |
docs/setup-manifest.md |
Cloud resources and CI secret checklist |
Built with ❤️ by Epic Web