avemguvern
Provides read-only access to the current government status of Romania via the get_government_status tool.
README
avemguvern.ro
A one-question site: does Romania currently have a (full, non-interim) government? Current answer: Nu! — Inca e interimar Bolojan!
Everything runs in a single Cloudflare Worker (free tier):
- Static page — minimalist verdict, served from
public/. - Public API —
GET /api/status(read),POST /api/status(admin, token-protected). - Crowd-sourced jokes —
POST /api/joke(public, body{"combo":["AUR","UDMR"],"joke":"..."}) lets visitors submit a joke for a party combination; stored but never shown live. Review them withGET /api/jokes(admin token):curl .../api/jokes -H "Authorization: Bearer $ADMIN_TOKEN". - MCP server — read-only
get_government_statustool at/mcp(Streamable HTTP).
State is one Cloudflare KV key (current). If KV is empty the Worker serves
DEFAULT_STATUS from src/index.ts, so it works before seeding.
Project layout
public/index.html # the page (no build step)
src/index.ts # Worker: routes /api/status, /mcp, else static assets
wrangler.jsonc # Worker + assets + KV config
seed.json # initial KV value
Local development
npm install
npx wrangler dev
Then:
# read
curl http://localhost:8787/api/status
# MCP: list tools
curl -X POST http://localhost:8787/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# MCP: call the tool
curl -X POST http://localhost:8787/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_government_status"}}'
For a local admin token during wrangler dev, create .dev.vars:
ADMIN_TOKEN=some-local-token
Deploy
npm install
npx wrangler login
# 1. Create the KV namespace, then paste the returned id into wrangler.jsonc
npx wrangler kv namespace create GOV_STATUS
# 2. Create the D1 database for joke suggestions, paste its database_id into
# wrangler.jsonc, then apply the schema to the remote database
npx wrangler d1 create avemguvern-suggestions
npx wrangler d1 execute avemguvern-suggestions --remote --file=./schema.sql
# 3. Set the admin token (used to authorize POST /api/status and GET /api/jokes)
npx wrangler secret put ADMIN_TOKEN
# 4. Deploy
npx wrangler deploy
# 5. (optional) Seed the KV value — default already matches
npm run seed
For local development, apply the schema to the local D1 once:
npx wrangler d1 execute avemguvern-suggestions --local --file=./schema.sql
Custom domain
After the first deploy, attach avemguvern.ro in the Cloudflare dashboard
(Workers & Pages → avemguvern-ro → Settings → Domains & Routes), or add to
wrangler.jsonc:
"routes": [{ "pattern": "avemguvern.ro", "custom_domain": true }]
(DNS for the domain must be on Cloudflare.)
Updating the status
When the political situation changes, patch the status (only send fields that change):
curl -X POST https://avemguvern.ro/api/status \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"hasGovernment": true, "answer": "Da!", "subtitle": "Avem guvern plin!", "interim": false, "primeMinister": "..."}'
updatedAt is stamped automatically.
Using the MCP server with Claude
Visit https://avemguvern.ro/mcp in a browser for setup instructions, or add it directly:
claude mcp add --transport http avemguvern https://avemguvern.ro/mcp
It exposes one read-only tool, get_government_status, that returns the current answer
plus the raw status JSON.
Abuse protection
Built into the Worker:
- Edge caching —
GET /api/statusis cached at the Cloudflare edge via the Cache API (caches.default) forCACHE_TTL_SECONDS(default 60), so a read flood hits KV at most ~once/minute per data center. A successfulPOSTpurges the cache so updates show immediately. The Cache API is per-colo, so a write purges only the data center that served it; other regions refresh when their TTL expires (hence the modest default — raise it inwrangler.jsoncvars for more offload if you can tolerate longer cross-region staleness after a change). - Per-IP rate limiting — native Workers rate-limit bindings: reads 120/min,
writes 10/min (the write limit also throttles token guessing). Over-limit →
429. - Hardened writes —
POSTonly accepts the known fields (hasGovernment,interim,answer,subtitle,primeMinister) with correct types, clamps strings to 200 chars, rejects bodies over 2 KB (413), and compares the admin token in constant time. A leaked token can't store arbitrary or huge data.
Recommended at the Cloudflare edge (dashboard):
- WAF Rate Limiting rule (e.g. per-IP threshold on
/api/*and/mcp) — this is the layer that drops abusive traffic before it counts against your quota. - Bot Fight Mode under Security → Bots.
Note: a zone-level Cache Rule cannot bypass the Worker here — for a Worker-owned route the Worker always executes before the cache is checked (docs). The in-Worker Cache API above is the effective edge-cache mechanism; it saves KV operations but each request still counts as one Worker invocation. To cut invocations themselves, use the WAF rate-limit rule.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.