FOR DEVELOPERS & AI AGENTS
Query the Mac Cloud Index
Give your assistant access to the same sourced catalog you see in the directory: macOS CI runners, dedicated Macs and virtual machines.
Connect with MCP
Add this URL as a remote MCP server in your client. Use Streamable HTTP; no account or API key is required.
https://maccloudindex.com/mcpA typical client configuration looks like this. Your client may also require a transport field such as "type": "http".
{
"mcpServers": {
"mac-cloud-index": {
"url": "https://maccloudindex.com/mcp"
}
}
}Available tools
- list_providers
- Find a provider by name, or browse provider IDs.
- get_catalog_filters
- Discover supported chips, regions, billing units and software versions for a category.
- search_offers
- Filter configurations by category, provider, chip, RAM, region, billing, software, included service or documented capability.
- get_provider
- Read a company profile, shared evidence, MCI assessment breakdowns, review gaps and its resource listings.
- get_offer
- Read complete configuration details, native prices, billing minimums, source links and observation dates.
Try a catalog query
Ask your assistant: “Find dedicated M4 Macs with at least 32 GB of RAM. Show native prices, minimum commitments and sources.”
The assistant can discover filter values, search configurations, then retrieve the full evidence for each match. Categories are ci, dedicated and vms. Search text matches literal text; the client turns your question into structured filters.
Keep the evidence with the answer
Every data response identifies its catalog release and publication time. Facts include source links and observation dates. Publication time is not the date every fact was checked.
Prices retain their native currency, billing period, minimum commitment and regional scope. The catalog does not establish live stock. Missing information remains unknown, and inferred capabilities require confirmation from the provider. Retrieve complete offer details before comparing prices or making a recommendation.
Services and provider assessments
Offer summaries include canonical services with delivery, entitlement, conditions and source evidence. Built-in publishing is distinct from customer-run upload scripts. Use get_catalog_filters to discover service values; the service filter requires current, explicitly supported and included services.
providerAssessment identifies the category, reference plan, rubric version and score. These are historical service assessments retained for compatibility; a pending score is null, never zero. Use get_provider or get_offer for the complete criterion evidence. sort: "mci" remains a compatibility option. Use value and sort: "value" for the current offering-value calculation. Read the scoring methodology.
Usage
Offering summaries include value: a numeric 0–100 score for every offering, separate confidence, the modeled bill or partial estimate, assumptions, evidence and reference prices. The price formula is 100 × reference price ÷ (reference price + offering price). Missing fields broaden the comparison or produce a provisional capacity score; no usable inputs give a neutral 50. Eligible zero-cost usage scores 100. search_offers accepts sort: "value", ciMinutes, months, jobMinutes, repository, appleMembership and rentalHours. Shared account credits are assumed already used. Provider assessment fields remain for compatibility and do not contribute to offering value.
Read-only public data. Results are paginated, with up to 20 listings per call. The endpoint applies an approximate limit of 120 POST requests per minute per IP at each Cloudflare location; clients sharing an IP share that allowance. On HTTP 429, respect the Retry-After header.
Native MCP clients can connect without a browser Origin header. Browser access is allowed from this site and localhost development tools. A connection is required: publishing an MCP endpoint does not automatically connect every AI service.