Cloud FinOps Skill & MCP is an MCP server published by io.github.OptimNow, hosted at mcp.optimnow.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 7 tools, including list_references, get_reference, find_references, list_playbooks, get_playbook.
Cloud cost + FinOps knowledge for AI agents: AWS/Azure/GCP optimisation, AI spend, waste playbooks.
2 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
See what FinOps guidance is available: billing mechanics, commitment strategy, allocation and chargeback, AI cost management, and per-provider cost handbooks (AWS, Azure, GCP, OCI, Databricks, Snowflake, ...). Use this to discover what the library covers. When the question already names a FinOps domain, phase, persona or maturity, ``find_references`` returns only the matching references. Returns a dict shaped ``{"references": [...], "total": N}`` where each entry includes ``name``, ``title``, a one-line ``description``, the discriminating FCP facets (``fcp_domain``, ``fcp_capability``, ``fcp_phases``, ``fcp_personas_primary``, ``fcp_maturity_entry``) and ``approx_tokens``. ``approx_tokens`` gives each file's size before it is fetched: the library runs from about 2,000 to about 15,000 tokens per file, and ``get_reference(name, section=...)`` returns one section of a large one.
No parameters.
{
"name": "list_references",
"title": "Browse the FinOps knowledge library",
"description": "See what FinOps guidance is available: billing mechanics, commitment\n strategy, allocation and chargeback, AI cost management, and per-provider\n cost handbooks (AWS, Azure, GCP, OCI, Databricks, Snowflake, ...).\n\n Use this to discover what the library covers. When the question already\n names a FinOps domain, phase, persona or maturity, ``find_references``\n returns only the matching references.\n\n Returns a dict shaped ``{\"references\": [...], \"total\": N}`` where each\n entry includes ``name``, ``title``, a one-line ``description``, the\n discriminating FCP facets (``fcp_domain``, ``fcp_capability``,\n ``fcp_phases``, ``fcp_personas_primary``, ``fcp_maturity_entry``) and\n ``approx_tokens``.\n\n ``approx_tokens`` gives each file's size before it is fetched: the library\n runs from about 2,000 to about 15,000 tokens per file, and\n ``get_reference(name, section=...)`` returns one section of a large one.\n ",
"inputSchema": {
"type": "object",
"title": "list_referencesArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "list_referencesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Browse the FinOps knowledge library",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Fetch the guidance on one FinOps topic - the billing mechanics, decision rules and worked examples behind a defensible answer - either whole or one section at a time. Use this when you need the actual content of one known reference, after ``list_references`` or ``find_references`` told you which one serves the question. Advisory questions (commitment sizing, chargeback design, allocation methodology) are served by the reference's decision rules and worked examples, which a summary does not carry. ``section`` is useful when the question is narrower than the file. The ``approx_tokens`` hint in the listing shows when this matters: the largest references run to about 15,000 tokens and the Azure pattern catalogue is an enumerated list, so a question about storage lifecycle is served by one section of ``finops-azure-patterns``. Without ``section`` the whole file comes back, with its cross-cutting reasoning. Args: name: Reference name as returned by ``list_references`` (e.g. ``"finops-aws"``, ``"finops-genai-capacity"``, ``"optimnow-methodology"``). section: Optional H2 or H3 heading to return on its own. Matched case-insensitively and partially against the headings, so a natural phrase works - ``"storage"``, ``"commitment decision tree"``. A heading's trailing count is ignored, so ``"storage optimization patterns"`` matches ``"Storage Optimization Patterns (28)"``. If it matches nothing you get the list of available headings back, not the whole file. Without ``section``, returns ``{"name": ..., "content": "...", "lines": N}`` where ``content`` is the file verbatim. With ``section``, returns ``{"name", "title", "section", "section_level", "partial": true, "content", "lines", "full_lines"}`` where ``content`` is that section prefixed by the reference's title, plus ``other_matching_sections`` when the phrase matched more than one heading. On a miss, returns ``{"error": ..., "suggestions": [...]}``. An unknown name gives up to three string-distance matches; an unmatched ``section`` gives ``available_sections`` - every heading in the file - so the retry is exact.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| section | any |
{
"name": "get_reference",
"title": "Read one FinOps guide",
"description": "Fetch the guidance on one FinOps topic - the billing mechanics,\n decision rules and worked examples behind a defensible answer - either\n whole or one section at a time.\n\n Use this when you need the actual content of one known reference,\n after ``list_references`` or ``find_references`` told you which one\n serves the question. Advisory questions (commitment sizing, chargeback\n design, allocation methodology) are served by the reference's decision\n rules and worked examples, which a summary does not carry.\n\n ``section`` is useful when the question is narrower than the file. The\n ``approx_tokens`` hint in the listing shows when this matters: the\n largest references run to about 15,000 tokens and the Azure pattern\n catalogue is an enumerated list, so a question about storage lifecycle is\n served by one section of ``finops-azure-patterns``. Without ``section``\n the whole file comes back, with its cross-cutting reasoning.\n\n Args:\n name: Reference name as returned by ``list_references`` (e.g.\n ``\"finops-aws\"``, ``\"finops-genai-capacity\"``,\n ``\"optimnow-methodology\"``).\n section: Optional H2 or H3 heading to return on its own. Matched\n case-insensitively and partially against the headings, so a\n natural phrase works - ``\"storage\"``, ``\"commitment decision\n tree\"``. A heading's trailing count is ignored, so\n ``\"storage optimization patterns\"`` matches\n ``\"Storage Optimization Patterns (28)\"``. If it matches nothing\n you get the list of available headings back, not the whole file.\n\n Without ``section``, returns ``{\"name\": ..., \"content\": \"...\",\n \"lines\": N}`` where ``content`` is the file verbatim. With ``section``,\n returns ``{\"name\", \"title\", \"section\", \"section_level\", \"partial\": true,\n \"content\", \"lines\", \"full_lines\"}`` where ``content`` is that section\n prefixed by the reference's title, plus ``other_matching_sections`` when\n the phrase matched more than one heading.\n\n On a miss, returns ``{\"error\": ..., \"suggestions\": [...]}``. An unknown\n name gives up to three string-distance matches; an unmatched ``section``\n gives ``available_sections`` - every heading in the file - so the retry\n is exact.\n ",
"inputSchema": {
"type": "object",
"title": "get_referenceArguments",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"section": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Section",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"title": "get_referenceDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Read one FinOps guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find which guidance serves a FinOps question - how to commit, size, allocate, charge back, forecast, or govern cloud and AI spend. Use this with ``query`` for a question in the user's own words rather than in FinOps Framework terms: "how should we size our first Savings Plan when usage is seasonal", "we hold SQL Server licences with Software Assurance, BYOL or licence-included?", "our forecast missed by 20%", "who should own commitment purchases", "combien s'engager en Savings Plans". Every guide declares the questions it answers (English and French); the result is ranked by those, then by title and section headings, and each entry carries ``matched_question`` and ``suggested_section``, the heading that ``get_reference(name=, section=)`` takes. The facets narrow the set first; ``query`` ranks what is left. Use this with the facets alone for a question already in FinOps Framework terms (domain, capability, phase, persona, maturity): "what does a Crawl-stage org tackle first", "the Engineering reading list", "what should Finance own in chargeback". All filters are optional and combine with AND semantics. Facet matching is case-insensitive and exact (not substring). Examples: - ``find_references(query="our forecast missed by 20%, was it the model or the drivers")`` - ``find_references(domain="Optimize Usage & Cost")`` - ``find_references(phase="Optimize", persona="Engineering")`` - ``find_references(persona="Engineering", persona_primary_only=True)`` - ``find_references(capability="Rate Optimization")`` - ``find_references(maturity="Crawl")`` Args: query: the user's question or symptom in their own words, up to 1,000 characters, English or French. Ranks the facet-filtered guides by the questions they declare, their title and their headings; returns at most five, best first, each with ``match_score``, ``matched_question`` and ``suggested_section``. domain: FinOps Framework domain (e.g. ``"Optimize Usage & Cost"``, ``"Quantify Business Value"``, ``"Manage the FinOps Practice"``). capability: FinOps capability (matches ``fcp_capability`` and ``fcp_capabilities_secondary``). phase: FinOps phase (``"Inform"``, ``"Optimize"``, ``"Operate"``). persona: Persona (matches ``fcp_personas_primary`` and ``fcp_personas_collaborating``). maturity: Entry maturity level (``"Crawl"``, ``"Walk"``, ``"Run"``). persona_primary_only: when True, ``persona`` matches only the primary list. Useful when the default match barely narrows the set - broad personas like Engineering collaborate on nearly every file, so filtering on collaboration is descriptive, not discriminating. ``persona="Engineering", persona_primary_only=True`` is the engineering reading list; the default is the everything-they-touch view. Returns ``{"filters": {...}, "references": [...], "total": N}``. With ``query`` the entries are ranked and capped at five. A facet filter that matches nothing also returns `hint` and `valid_values`, so a typo is distinguishable from a genuine gap in coverage; a ``query`` that matches nothing returns `hint` alone.
| Parameter | Type | Description |
|---|---|---|
| phase | any | |
| query | any | |
| domain | any | |
| persona | any | |
| maturity | any | |
| capability | any | |
| persona_primary_only | boolean |
{
"name": "find_references",
"title": "Find the right FinOps guide",
"description": "Find which guidance serves a FinOps question - how to commit, size,\n allocate, charge back, forecast, or govern cloud and AI spend.\n\n Use this with ``query`` for a question in the user's own words rather\n than in FinOps Framework terms: \"how should we size our first Savings\n Plan when usage is seasonal\", \"we hold SQL Server licences with Software\n Assurance, BYOL or licence-included?\", \"our forecast missed by 20%\",\n \"who should own commitment purchases\", \"combien s'engager en Savings\n Plans\". Every guide declares the questions it answers (English and\n French); the result is ranked by those, then by title and section\n headings, and each entry carries ``matched_question`` and\n ``suggested_section``, the heading that ``get_reference(name=,\n section=)`` takes. The facets narrow the set first; ``query`` ranks what\n is left.\n\n Use this with the facets alone for a question already in FinOps\n Framework terms (domain, capability, phase, persona, maturity): \"what\n does a Crawl-stage org tackle first\", \"the Engineering reading list\",\n \"what should Finance own in chargeback\".\n\n All filters are optional and combine with AND semantics. Facet matching\n is case-insensitive and exact (not substring). Examples:\n\n - ``find_references(query=\"our forecast missed by 20%, was it the model or the drivers\")``\n - ``find_references(domain=\"Optimize Usage & Cost\")``\n - ``find_references(phase=\"Optimize\", persona=\"Engineering\")``\n - ``find_references(persona=\"Engineering\", persona_primary_only=True)``\n - ``find_references(capability=\"Rate Optimization\")``\n - ``find_references(maturity=\"Crawl\")``\n\n Args:\n query: the user's question or symptom in their own words, up to\n 1,000 characters, English or French. Ranks the facet-filtered guides by\n the questions they declare, their title and their headings;\n returns at most five, best first, each with ``match_score``,\n ``matched_question`` and ``suggested_section``.\n domain: FinOps Framework domain (e.g. ``\"Optimize Usage & Cost\"``,\n ``\"Quantify Business Value\"``, ``\"Manage the FinOps Practice\"``).\n capability: FinOps capability (matches ``fcp_capability`` and\n ``fcp_capabilities_secondary``).\n phase: FinOps phase (``\"Inform\"``, ``\"Optimize\"``, ``\"Operate\"``).\n persona: Persona (matches ``fcp_personas_primary`` and\n ``fcp_personas_collaborating``).\n maturity: Entry maturity level (``\"Crawl\"``, ``\"Walk\"``, ``\"Run\"``).\n persona_primary_only: when True, ``persona`` matches only the primary\n list. Useful when the default match barely narrows the set -\n broad personas like Engineering collaborate on nearly every file,\n so filtering on collaboration is descriptive, not discriminating.\n ``persona=\"Engineering\", persona_primary_only=True`` is the\n engineering reading list; the default is the everything-they-touch\n view.\n\n Returns ``{\"filters\": {...}, \"references\": [...], \"total\": N}``. With\n ``query`` the entries are ranked and capped at five. A facet filter that\n matches nothing also returns `hint` and `valid_values`, so a typo is\n distinguishable from a genuine gap in coverage; a ``query`` that matches\n nothing returns `hint` alone.\n ",
"inputSchema": {
"type": "object",
"title": "find_referencesArguments",
"properties": {
"phase": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Phase",
"default": null
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Domain",
"default": null
},
"persona": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Persona",
"default": null
},
"maturity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Maturity",
"default": null
},
"capability": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Capability",
"default": null
},
"persona_primary_only": {
"type": "boolean",
"title": "Persona Primary Only",
"default": false
}
}
},
"outputSchema": {
"type": "object",
"title": "find_referencesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find the right FinOps guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}See every ready-made runbook for finding and fixing cloud waste: idle, orphaned and overprovisioned resources, egress surprises, schedule blindness and AI/ML inefficiency across AWS, Azure and GCP. Use this to discover which waste patterns have a runbook. When the question already names a provider, waste category, or confidence tier, ``find_playbooks`` returns only the matching runbooks. Each playbook is a small (~90-170 line) runbook scoped to one waste pattern (e.g. ``aws-zombie-nat-gateway``, ``azure-orphan-disks``). Returns ``{"playbooks": [...], "total": N}`` where each entry includes ``name``, ``title``, ``scope`` (aws/azure/gcp/cross-cloud), ``service``, ``waste_category``, ``confidence`` (obvious/likely/possible), and ``approx_tokens`` - the same size hint the reference listing carries, so a multi-playbook answer can be budgeted before fetching.
No parameters.
{
"name": "list_playbooks",
"title": "Browse the cloud waste runbooks",
"description": "See every ready-made runbook for finding and fixing cloud waste:\n idle, orphaned and overprovisioned resources, egress surprises,\n schedule blindness and AI/ML inefficiency across AWS, Azure and GCP.\n\n Use this to discover which waste patterns have a runbook. When the\n question already names a provider, waste category, or confidence tier,\n ``find_playbooks`` returns only the matching runbooks.\n\n Each playbook is a small (~90-170 line) runbook scoped to one waste\n pattern (e.g. ``aws-zombie-nat-gateway``, ``azure-orphan-disks``). Returns\n ``{\"playbooks\": [...], \"total\": N}`` where each entry includes ``name``,\n ``title``, ``scope`` (aws/azure/gcp/cross-cloud), ``service``,\n ``waste_category``, ``confidence`` (obvious/likely/possible), and\n ``approx_tokens`` - the same size hint the reference listing carries, so a\n multi-playbook answer can be budgeted before fetching.\n ",
"inputSchema": {
"type": "object",
"title": "list_playbooksArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "list_playbooksDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Browse the cloud waste runbooks",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch the step-by-step runbook for one specific waste pattern: symptoms, the detection queries to run, the fix, and the anti-pattern to avoid. Use this when the user asks how to detect, confirm, or fix one specific named waste pattern (zombie NAT gateway, snapshot sprawl, idle SageMaker endpoint, ...), including questions about the user's own resources ("which of my X..."). Each runbook includes a detection query the user can run in their own cloud account; this connector has no access to the user's accounts. Args: name: Playbook slug as returned by ``list_playbooks`` (e.g. ``"aws-zombie-nat-gateway"``, ``"azure-orphan-disks"``, ``"cross-cloud-untagged-spend-drift"``). Returns ``{"name": ..., "title": ..., "content": "...", "lines": N}``. On miss, returns ``{"error": ..., "suggestions": [...]}`` with up to three string-distance matches so the caller can self-correct.
| Parameter | Type | Description |
|---|---|---|
| name * | string |
{
"name": "get_playbook",
"title": "Read one waste runbook",
"description": "Fetch the step-by-step runbook for one specific waste pattern:\n symptoms, the detection queries to run, the fix, and the anti-pattern\n to avoid.\n\n Use this when the user asks how to detect, confirm, or fix one specific\n named waste pattern (zombie NAT gateway, snapshot sprawl, idle SageMaker\n endpoint, ...), including questions about the user's own resources\n (\"which of my X...\"). Each runbook includes a detection query the user\n can run in their own cloud account; this connector has no access to the\n user's accounts.\n\n Args:\n name: Playbook slug as returned by ``list_playbooks`` (e.g.\n ``\"aws-zombie-nat-gateway\"``, ``\"azure-orphan-disks\"``,\n ``\"cross-cloud-untagged-spend-drift\"``).\n\n Returns ``{\"name\": ..., \"title\": ..., \"content\": \"...\", \"lines\": N}``.\n On miss, returns ``{\"error\": ..., \"suggestions\": [...]}`` with up to\n three string-distance matches so the caller can self-correct.\n ",
"inputSchema": {
"type": "object",
"title": "get_playbookArguments",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
}
}
},
"outputSchema": {
"type": "object",
"title": "get_playbookDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Read one waste runbook",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Finds runbooks for a suspected cloud-waste pattern, filterable by provider, service, waste category or detection confidence. Useful when the user asks how to detect or fix a specific waste pattern; each runbook includes a detection query the user can run in their own account. This connector has no access to the user's accounts. Use this with ``query`` for a symptom or a "which of my X" question in the user's own words: "our AWS bill has NAT gateway charges but nothing uses them", "which of my RIs are about to expire", "my NAT gateway processes 10TB to S3", "should I delete these old snapshots", "our Log Analytics ingestion doubled", "which VMs are running for nothing", "passerelle NAT qui ne sert à rien". Every runbook declares the questions it answers (English and French); the result is ranked by those, then by title and service, and carries ``matched_question``; the first entry is the one ``get_playbook(name=)`` fetches. Facets narrow the set first; ``query`` ranks what is left. Use this with the facets alone to browse: "what waste can we clean up safely without review" (confidence), "every idle pattern on Azure" (scope and waste category). Patterns covered include NAT gateways and VPC endpoints, expiring Savings Plans / RIs / reservations, snapshot sprawl, S3 lifecycle gaps, idle or stopped VMs, orphaned disks / public IPs / EBS volumes, GPU and SageMaker sizing, Kubernetes idle capacity, and schedule blindness. All filters are optional and combine with AND semantics. String matching is case-insensitive and exact. Examples: - ``find_playbooks(query="which of my RIs are about to expire")`` - ranked runbooks - ``find_playbooks(scope="aws")`` - all AWS-specific playbooks - ``find_playbooks(waste_category="idle")`` - every idle-resource pattern - ``find_playbooks(scope="cross-cloud", confidence="obvious")`` Args: query: the user's symptom or question in their own words, up to 1,000 characters, English or French. Ranks the facet-filtered runbooks by the questions they declare, their title and their service; returns at most five, best first, each with ``match_score`` and ``matched_question`` (a runbook is read whole, so its ``suggested_section`` is null). scope: ``"aws"``, ``"azure"``, ``"gcp"``, or ``"cross-cloud"``. service: Provider service exact-match (e.g. ``"AWS NAT Gateway"``). waste_category: ``"orphaned"``, ``"idle"``, ``"overprovisioned"``, ``"commitment-mismatch"``, ``"schedule-blindness"``, ``"modernization"``, ``"ai-ml-inefficiency"``, or ``"egress"``. confidence: ``"obvious"`` (single signal is enough), ``"likely"`` (two signals required), or ``"possible"`` (needs human review). From the OptimNow three-tier confidence model in `finops-waste-detection-playbooks`. Returns ``{"filters": {...}, "playbooks": [...], "total": N}``. With ``query`` the entries are ranked and capped at five. A facet filter that matches nothing also returns `hint` and `valid_values`, so a typo is distinguishable from a genuine gap in coverage; a ``query`` that matches nothing returns `hint` alone.
| Parameter | Type | Description |
|---|---|---|
| query | any | |
| scope | any | |
| service | any | |
| confidence | any | |
| waste_category | any |
{
"name": "find_playbooks",
"title": "Find a waste runbook",
"description": "Finds runbooks for a suspected cloud-waste pattern, filterable by\n provider, service, waste category or detection confidence. Useful when\n the user asks how to detect or fix a specific waste pattern; each\n runbook includes a detection query the user can run in their own\n account. This connector has no access to the user's accounts.\n\n Use this with ``query`` for a symptom or a \"which of my X\" question in\n the user's own words: \"our AWS bill has NAT gateway charges but nothing\n uses them\", \"which of my RIs are about to expire\", \"my NAT gateway\n processes 10TB to S3\", \"should I delete these old snapshots\", \"our Log\n Analytics ingestion doubled\", \"which VMs are running for nothing\",\n \"passerelle NAT qui ne sert à rien\". Every runbook declares the\n questions it answers (English and French); the result is ranked by\n those, then by title and service, and carries ``matched_question``; the\n first entry is the one ``get_playbook(name=)`` fetches. Facets narrow\n the set first; ``query`` ranks what is left.\n\n Use this with the facets alone to browse: \"what waste can we clean up safely\n without review\" (confidence), \"every idle pattern on Azure\" (scope and\n waste category). Patterns covered include NAT gateways and VPC\n endpoints, expiring Savings Plans / RIs / reservations, snapshot\n sprawl, S3 lifecycle gaps, idle or stopped VMs, orphaned disks / public\n IPs / EBS volumes, GPU and SageMaker sizing, Kubernetes idle capacity,\n and schedule blindness.\n\n All filters are optional and combine with AND semantics. String matching\n is case-insensitive and exact. Examples:\n\n - ``find_playbooks(query=\"which of my RIs are about to expire\")`` - ranked runbooks\n - ``find_playbooks(scope=\"aws\")`` - all AWS-specific playbooks\n - ``find_playbooks(waste_category=\"idle\")`` - every idle-resource pattern\n - ``find_playbooks(scope=\"cross-cloud\", confidence=\"obvious\")``\n\n Args:\n query: the user's symptom or question in their own words, up to\n 1,000 characters, English or French. Ranks the facet-filtered runbooks by\n the questions they declare, their title and their service;\n returns at most five, best first, each with ``match_score``\n and ``matched_question`` (a runbook is read whole, so its\n ``suggested_section`` is null).\n scope: ``\"aws\"``, ``\"azure\"``, ``\"gcp\"``, or ``\"cross-cloud\"``.\n service: Provider service exact-match (e.g. ``\"AWS NAT Gateway\"``).\n waste_category: ``\"orphaned\"``, ``\"idle\"``, ``\"overprovisioned\"``,\n ``\"commitment-mismatch\"``, ``\"schedule-blindness\"``,\n ``\"modernization\"``, ``\"ai-ml-inefficiency\"``, or ``\"egress\"``.\n confidence: ``\"obvious\"`` (single signal is enough),\n ``\"likely\"`` (two signals required), or ``\"possible\"``\n (needs human review). From the OptimNow three-tier confidence\n model in `finops-waste-detection-playbooks`.\n\n Returns ``{\"filters\": {...}, \"playbooks\": [...], \"total\": N}``. With\n ``query`` the entries are ranked and capped at five. A facet filter that\n matches nothing also returns `hint` and `valid_values`, so a typo is\n distinguishable from a genuine gap in coverage; a ``query`` that matches\n nothing returns `hint` alone.\n ",
"inputSchema": {
"type": "object",
"title": "find_playbooksArguments",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"scope": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Scope",
"default": null
},
"service": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Service",
"default": null
},
"confidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Confidence",
"default": null
},
"waste_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Waste Category",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"title": "find_playbooksDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find a waste runbook",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the current value of a figure a reference quotes with a date. Use this when a reference quotes a figure from an OptimToken guide ("measured on the 2026-10-25 OptimToken catalogue") and the answer needs the current value: the Compute Savings Plan or reservation discount, the gap between a flexible and a locked commitment, the ARM discount against Intel and AMD, the share of LLM models with a batch rate. It fetches the guide's figures file, rebuilt daily, and returns it as published. Args: guide: The guide slug, lowercase letters, digits and hyphens. Guides with figures today: ``"savings-plans-vs-reserved-instances"``, ``"arm-against-x86"``, ``"batch-api-economics"``. Returns ``{"document": {...}, "fetched_at": ..., "source": "live" | "cached", "note": ...}``, plus ``cache_age_seconds`` when cached (six-hour cache). ``document`` is the file unchanged: ``guide``, ``title``, ``url``, ``dataSource``, ``snapshotDate`` (the catalogue the figures come from), ``dateModified`` and ``figures``, where discounts are fractions (0.2743 is 27.4%) and each key names a median, a range or a count. An unknown slug returns ``{"error", "available_guides", "suggestions"}``. Any other failure (timeout, HTTP error, invalid JSON, a file that is not figures and short labels) returns ``{"error", "fallback"}``: the dated figure in the reference then stands, quoted with its date.
| Parameter | Type | Description |
|---|---|---|
| guide * | string |
{
"name": "get_live_figures",
"title": "Current figures from an OptimToken guide",
"description": "Get the current value of a figure a reference quotes with a date.\n\n Use this when a reference quotes a figure from an OptimToken guide\n (\"measured on the 2026-10-25 OptimToken catalogue\") and the answer needs\n the current value: the Compute Savings Plan or reservation discount, the\n gap between a flexible and a locked commitment, the ARM discount against\n Intel and AMD, the share of LLM models with a batch rate. It fetches the\n guide's figures file, rebuilt daily, and returns it as published.\n\n Args:\n guide: The guide slug, lowercase letters, digits and hyphens. Guides\n with figures today: ``\"savings-plans-vs-reserved-instances\"``,\n ``\"arm-against-x86\"``, ``\"batch-api-economics\"``.\n\n Returns ``{\"document\": {...}, \"fetched_at\": ..., \"source\": \"live\" |\n \"cached\", \"note\": ...}``, plus ``cache_age_seconds`` when cached (six-hour\n cache). ``document`` is the file unchanged: ``guide``, ``title``,\n ``url``, ``dataSource``, ``snapshotDate`` (the catalogue the figures come\n from), ``dateModified`` and ``figures``, where discounts are fractions\n (0.2743 is 27.4%) and each key names a median, a range or a count.\n\n An unknown slug returns ``{\"error\", \"available_guides\", \"suggestions\"}``.\n Any other failure (timeout, HTTP error, invalid JSON, a file that is not\n figures and short labels) returns\n ``{\"error\", \"fallback\"}``: the dated figure in the reference then stands,\n quoted with its date.\n ",
"inputSchema": {
"type": "object",
"title": "get_live_figuresArguments",
"required": [
"guide"
],
"properties": {
"guide": {
"type": "string",
"title": "Guide"
}
}
},
"outputSchema": {
"type": "object",
"title": "get_live_figuresDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Current figures from an OptimToken guide",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Cloud FinOps knowledge by OptimNow. Two retrieval surfaces: REFERENCES (long-form provider/discipline files) and PLAYBOOKS (small named-pattern runbooks for specific waste patterns). REFERENCES: list_references() to discover, find_references(query=, domain=, capability=, phase=, persona=, maturity=, persona_primary_only=) to route a question - query= takes the user's own wording (English or French) and ranks by the questions each file declares it answers, the facets narrow by FinOps Capability/Phase - and get_reference(name=, section=) to fetch one body. Every listing entry carries approx_tokens: references run from about 2,000 to about 15,000 tokens. get_reference(name=, section="<heading phrase>") returns one section instead of the whole file - section matches H2 and H3 headings case-insensitively and partially, and a miss returns the file's available_sections rather than the whole body. The Azure pattern catalogue (finops-azure-patterns) is an enumerated list, usually needed one section at a time; the AWS catalogue is one file per service family (finops-aws-patterns-compute, -storage, -databases, -networking, -other). PLAYBOOKS: list_playbooks() to discover, find_playbooks(query=, scope=, service=, waste_category=, confidence=) to route a symptom or a 'which of my X' question (query= takes the user's wording) or to narrow by pattern facets, get_playbook(name=) to fetch one body. A playbook serves 'how do I detect/fix this specific pattern' (zombie NAT, snapshot sprawl, idle ELB, etc.); a reference serves billing mechanics, commitment strategy, allocation methodology and cross-pattern reasoning. This connector has no access to the user's cloud accounts. For questions about the user's own resources ('which of my RIs are about to expire', 'which of our VMs run for nothing'), the matching playbook includes a detection query the user can run in their own account. For a specific waste or cost-fix question ('my NAT gateway processes 10TB to S3', 'should I delete these old snapshots'), find_playbooks returns the named runbook with its tested detection query. Runbooks exist for NAT gateways and VPC endpoints, expiring Savings Plans / RIs / reservations, snapshots, S3 lifecycle, idle or stopped VMs, orphaned disks and IPs, GPU and SageMaker sizing, and more. References carry billing mechanics, not current prices: any figure inside is illustrative and dated inline. Where a reference quotes a figure from an OptimToken guide with its date, get_live_figures(guide=) returns that guide's current figures with the snapshotDate to quote them by. For 'what changed recently' or 'what is coming' questions, get_reference(name='finops-whats-new') is a dated digest of the provider changes verified over the last 90 days: 'Scheduled changes' and one section for each of the current and previous month, with the earlier months of the window in 'finops-whats-new-earlier'. State its as-of date. Advisory questions - how much to commit, how to size, how to allocate or charge back - are served by a matching reference (finops-aws-commitments for Savings Plan sizing, finops-chargeback for recharge design), which carries the decision rules and cadence tables behind a defensible answer.
Names, descriptions and schemas were written by the server and are shown as data.