# rukuma.dev

> An agentic website built on Cloudflare's edge — agent-readable, AI-searchable, and MCP-enabled.

## Pages

- [Build an Agentic Website — Developer Spec & Checklist](https://rukuma.dev/build-agentic-website-prompt): A complete, vendor-neutral specification for building a website that is agent-readable, AI-searchable, MCP-enabled, and browser-tool-discoverable. Includes implementation checklist.
- [Rukuma.dev](https://rukuma.dev/home): An agentic website on the edge
- [What is the Agentic Web?](https://rukuma.dev/what-is-agentic-web): Understanding the shift from human-first to agent-first web
- [Building on Cloudflare Free Tier](https://rukuma.dev/building-on-cloudflare-free): How to build a full-stack site on $0/month
- [Stateless MCP Servers on Workers](https://rukuma.dev/mcp-stateless-servers): How MCP 2026-07-28 enables stateless agent servers

## Markdown Versions

- [Build an Agentic Website — Developer Spec & Checklist (markdown)](https://rukuma.dev/md/build-agentic-website-prompt)
- [Rukuma.dev (markdown)](https://rukuma.dev/md/home)
- [What is the Agentic Web? (markdown)](https://rukuma.dev/md/what-is-agentic-web)
- [Building on Cloudflare Free Tier (markdown)](https://rukuma.dev/md/building-on-cloudflare-free)
- [Stateless MCP Servers on Workers (markdown)](https://rukuma.dev/md/mcp-stateless-servers)

## API

- [Health Check](https://rukuma.dev/api/health): Server status
- [List Pages](https://rukuma.dev/api/pages): All published pages (JSON)
- [Page Detail](https://rukuma.dev/api/page/<slug>): Full page data (JSON)
- [Search](https://rukuma.dev/api/search): POST {"query": "..."} — semantic search
- [Agent Stats](https://rukuma.dev/api/agent-stats): AI agent visit analytics

## MCP

This site exposes a stateless MCP server at https://rukuma.dev/mcp

Available tools:
- search(query, limit?) — semantic search across all content
- read_page(slug) — get full markdown of a page
- list_pages(category?) — list all available pages
- site_info() — site metadata and capabilities

## Info

- Author: Rukuma
- Built on: Cloudflare Workers (free tier)
- Protocol: MCP 2026-07-28 (stateless)
- Search: Vectorize + Workers AI (bge-m3 embeddings)