1. Connect the server
The user’s prompt gives the server URL. If it does not, usehttps://app.cloudcapital.co/api/v1/mcp/server.
Check whether you already have Cloud Capital tools, such as auth-status and list-organizations. If you do, go to step 2.
If you don’t, work out which app you are running in and give the user that app’s steps only. Tell them to come back to this conversation when they are done, then check again.
Claude (claude.ai, Claude Desktop, Claude mobile)
Cloud Capital is in Claude’s connector directory, as Cloud Capital. If you can suggest or connect a directory connector for the user, offer Cloud Capital. Otherwise give them these steps:
- Open Cloud Capital in the Claude directory.
- Click Connect, and sign in to Cloud Capital. Pick the organization to connect and click Authorize.
- Start a new conversation or turn the connector on in this one, from the + menu under Connectors.
Cloud Capital and the server URL above, then click Add and Connect. On a Team or Enterprise plan, only an Owner can add custom connectors.
ChatGPT
- Open Plugins.
- Click Add, then Add custom MCP server.
- Name:
Cloud Capital. Server URL: the URL above. Choose OAuth sign-in. - Accept the warning, create it, and sign in to Cloud Capital when asked. Pick the organization and click Authorize.
~/.cursor/mcp.json, or ask the user to use the Use Cloud Capital in your AI agent card in Cloud Capital, which installs it with one click:
/mcp in Claude Code, pick cloudcapital and sign in:
npx mcp-remote <server URL> as the command.
2. Confirm the connection
- Call
auth-status. If it reports no authentication, ask the user to reconnect and sign in. - Call
list-organizationsand tell the user which organization you are connected to.
3. Show the user their costs
Call these, read-only:list-billing-periods, thenget-cloud-bills-summaryfor the most recent complete periodget-cloud-bills-by-servicefor the same periodlist-commitmentsget-forecastlist-cost-layersandlist-business-metrics
- Total cloud spend last month, and the change from the month before.
- The top five services by spend.
- Commitments: how many, and any expiring in the next 90 days.
- The forecast for this month and next.
- Whether they have cost layers and business metrics set up. If they don’t, say that Cloud Capital can split costs by team or product once they do, and link Cost layers.
Which services grew the most last month? Which commitments expire soon, and what would renewing them save? What will we spend next quarter?
4. Bring in plans from the user’s other tools
Look at the other tools you have in this conversation, apart from Cloud Capital. Two kinds are useful:- Issue trackers and project tools, such as Linear, Jira, Asana or GitHub Issues. Look for planned work that will change cloud cost: migrations, rightsizing, shutting down environments, reserved capacity, new launches. Each one can become an initiative.
- Accounting, finance and planning tools, such as QuickBooks, Xero, NetSuite, Stripe, a planning spreadsheet, or a planning tool like Pigment or Causal. Look for numbers cloud cost grows with: revenue, customers, active users, orders, transactions. Each one can become a business metric.
- Call
list-initiativesandlist-business-metrics, so you don’t propose something that already exists. - Search the other tools and propose up to five initiatives and up to three business metrics. For each one, give:
- its name and a link to the issue, project, report or sheet it came from
- for an initiative: the services, accounts or cost layers it affects, the months it covers, and the expected monthly change in cost
- for a business metric: the monthly values you found and the months they cover
- If a source gives no cost estimate or no monthly values, say so and ask the user for them. Do not guess numbers.
- If something matches an existing initiative or metric, say which one, and leave it alone.
- Ask the user which to create. Create only those.
create-initiative, then create-initiative-mapping with its effects. Find what it targets with list-cost-layers or list-cost-insights-filters; each tool’s description says how.
To create a business metric, call create-business-metric, then update-business-metric with its name and monthly actuals, plus forecast if the source has a plan.
When you are done, list what you created, and link Initiatives and Business metrics so the user can review them.
5. Make it stick
Offer the user a custom instruction so their agent uses Cloud Capital for cost questions. Give it in a block they can copy:- Claude: personal preferences in Settings, or a Project’s instructions.
- ChatGPT: Settings → Personalization → Custom instructions.
- Cursor: Cursor Settings → Rules, as a user rule.
- Claude Code: the user’s
~/.claude/CLAUDE.md.
Changes
- 0.3.0, November 4, 2026: Claude users connect from the Claude connector directory. A custom connector is the fallback.
- 0.2.0, November 4, 2026: added step 4, creating initiatives and business metrics from the user’s other tools, with their approval.
- 0.1.0, November 4, 2026: first version.

