Add cloudflare-billing skill (Cloudflare REST API, no MCP)#53
Open
dalexeenko wants to merge 2 commits into
Open
Add cloudflare-billing skill (Cloudflare REST API, no MCP)#53dalexeenko wants to merge 2 commits into
dalexeenko wants to merge 2 commits into
Conversation
Adds skills/billing/ with a structured investigation playbook for helping confused customers debug Cloudflare and Stripe billing. Backed by the open-source, read-only mcp-billing-server MCP (https://github.com/dalexeenko/mcp-billing-server). Includes tools.json with the full JSON Schema for every tool the MCP exposes, so code-mode hosts can generate TypeScript types without first connecting to the server. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Address review feedback that a Cloudflare-hosted skill shouldn't require a non-Cloudflare MCP server. The skill now calls the public Cloudflare billing endpoints (account/user subscriptions, billing history, zone subscription) directly via curl with a scoped `Account → Billing → Read` token — same pattern as cloudflare-email-service. - Rename `skills/billing` → `skills/cloudflare-billing` to match the `cloudflare-<product>` convention used elsewhere in the repo. - Drop the Stripe portion entirely — it was also a non-Cloudflare dependency and the skill's purpose is Cloudflare-bill debugging. - Remove `tools.json` (was the MCP server's tool schema; no longer applicable). - Rewrite SKILL.md to document the four REST endpoints with example curl invocations and drop all references to mcp-billing-server. Investigation playbook (intake → subscriptions → history → reconcile → plain-language summary) is unchanged. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
maza15240gmail
approved these changes
May 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
skills/cloudflare-billing/— a structured investigation playbook that helps a confused Cloudflare customer make sense of their bill: outstanding balances, why they're on FREE/PRO/BUSINESS, possible double charges, pending authorizations, which zones/products drive cost.The skill calls the Cloudflare REST API directly via
curlwith a scopedAccount → Billing → Readtoken — no MCP server, no third-party dependencies. Same pattern ascloudflare-email-service.What's included
SKILL.md— Trigger description, prerequisites (one scoped Cloudflare token), the four REST endpoints used (with example curl invocations), a two-question-max intake, a three-step investigation order (subscriptions → billing history → reconcile), a presentation template, tone guidance, and edge cases (multi-account, deprecated history endpoint, missing per-product usage breakdown).Endpoints used (all read-only
GET)GET /accounts/{account_id}/subscriptionsGET /user/subscriptionsGET /user/billing/history?per_page=50GET /zones/{zone_id}/subscriptionChanges from the original PR
mcp-billing-serverper review feedback — the skill no longer requires a non-Cloudflare MCP server.tools.json(was the MCP server's tool schema; no longer applicable).billing→cloudflare-billingto match thecloudflare-<product>naming used bycloudflare-email-service.Notes
.mcp.json,marketplace.json, or the top-levelREADME.md— the skill is self-contained and uses only the public Cloudflare API.Test plan
SKILL.mdfrontmatternamematches the folder (cloudflare-billing)Account → Billing → Read)curlexample returns valid JSON against the live API🤖 Generated with Claude Code