Skip to main content
Glama

api_change_check__compare

One-off surface diff between two OpenAPI 3 specs (before/after), inline JSON. POST body: {"before":{...},"after":{...}} Price: $0.01 per call in USDC on Base (eip155:8453), paid with x402 in params._meta["x402/payment"]. HTTP: POST https://api.firstmention.uk/s/api-change-check/compare

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "before": "<before>",
      "after": "<after>"
    },
    "name": "api_change_check__compare"
  }
}

Input Schema

NameRequiredDescriptionDefault
afterYesOpenAPI 3 JSON after the change
beforeYesOpenAPI 3 JSON before the change

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • addedInput schema / properties / after / description
      Added value: +"OpenAPI 3 JSON after the change"
    • removedInput schema / properties / after / properties
      Removed value: -{
      -  "openapi": {
      -    "type": "string"
      -  },
      -  "paths": {
      -    "properties": {},
      -    "type": "object"
      -  }
      -}
    • addedInput schema / properties / before / description
      Added value: +"OpenAPI 3 JSON before the change"
    • removedInput schema / properties / before / properties
      Removed value: -{
      -  "openapi": {
      -    "type": "string"
      -  },
      -  "paths": {
      -    "properties": {
      -      "/a": {
      -        "properties": {
      -          "get": {
      -            "properties": {
      -              "responses": {
      -                "properties": {
      -                  "200": {
      -                    "properties": {},
      -                    "type": "object"
      -                  }
      -                },
      -                "type": "object"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  }
      -}
    • addedInput schema / required
      Added value: +[
      +  "before",
      +  "after"
      +]
  2. Changed7 schema fields changed
    • removedInput schema / properties / after / description
      Removed value: -"OpenAPI 3 JSON document as a string"
    • addedInput schema / properties / after / properties
      Added value: +{
      +  "openapi": {
      +    "type": "string"
      +  },
      +  "paths": {
      +    "properties": {},
      +    "type": "object"
      +  }
      +}
    • changedInput schema / properties / after / type
      Previous value: -"string"New value: +"object"
    • removedInput schema / properties / before / description
      Removed value: -"OpenAPI 3 JSON document as a string"
    • addedInput schema / properties / before / properties
      Added value: +{
      +  "openapi": {
      +    "type": "string"
      +  },
      +  "paths": {
      +    "properties": {
      +      "/a": {
      +        "properties": {
      +          "get": {
      +            "properties": {
      +              "responses": {
      +                "properties": {
      +                  "200": {
      +                    "properties": {},
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  }
      +}
    • changedInput schema / properties / before / type
      Previous value: -"string"New value: +"object"
    • removedInput schema / required
      Removed value: -[
      -  "before",
      -  "after"
      -]
  3. Changed7 schema fields changed
    • addedInput schema / properties / after / description
      Added value: +"OpenAPI 3 JSON document as a string"
    • removedInput schema / properties / after / properties
      Removed value: -{
      -  "openapi": {
      -    "type": "string"
      -  },
      -  "paths": {
      -    "properties": {
      -      "/a": {
      -        "properties": {
      -          "get": {
      -            "properties": {
      -              "responses": {
      -                "properties": {
      -                  "200": {
      -                    "properties": {},
      -                    "type": "object"
      -                  }
      -                },
      -                "type": "object"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "post": {
      -            "properties": {
      -              "responses": {
      -                "properties": {
      -                  "201": {
      -                    "properties": {},
      -                    "type": "object"
      -                  }
      -                },
      -                "type": "object"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  }
      -}
    • changedInput schema / properties / after / type
      Previous value: -"object"New value: +"string"
    • addedInput schema / properties / before / description
      Added value: +"OpenAPI 3 JSON document as a string"
    • removedInput schema / properties / before / properties
      Removed value: -{
      -  "openapi": {
      -    "type": "string"
      -  },
      -  "paths": {
      -    "properties": {
      -      "/a": {
      -        "properties": {
      -          "get": {
      -            "properties": {
      -              "responses": {
      -                "properties": {
      -                  "200": {
      -                    "properties": {},
      -                    "type": "object"
      -                  }
      -                },
      -                "type": "object"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  }
      -}
    • changedInput schema / properties / before / type
      Previous value: -"object"New value: +"string"
    • addedInput schema / required
      Added value: +[
      +  "before",
      +  "after"
      +]
  4. Changed5 schema fields changed
    • removedInput schema / properties / after / description
      Removed value: -"New OpenAPI 3.0/3.1 JSON document"
    • addedInput schema / properties / after / properties
      Added value: +{
      +  "openapi": {
      +    "type": "string"
      +  },
      +  "paths": {
      +    "properties": {
      +      "/a": {
      +        "properties": {
      +          "get": {
      +            "properties": {
      +              "responses": {
      +                "properties": {
      +                  "200": {
      +                    "properties": {},
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "post": {
      +            "properties": {
      +              "responses": {
      +                "properties": {
      +                  "201": {
      +                    "properties": {},
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  }
      +}
    • removedInput schema / properties / before / description
      Removed value: -"Old OpenAPI 3.0/3.1 JSON document"
    • addedInput schema / properties / before / properties
      Added value: +{
      +  "openapi": {
      +    "type": "string"
      +  },
      +  "paths": {
      +    "properties": {
      +      "/a": {
      +        "properties": {
      +          "get": {
      +            "properties": {
      +              "responses": {
      +                "properties": {
      +                  "200": {
      +                    "properties": {},
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  }
      +}
    • removedInput schema / required
      Removed value: -[
      -  "before",
      -  "after"
      -]
  5. Changed5 schema fields changed
    • addedInput schema / properties / after / description
      Added value: +"New OpenAPI 3.0/3.1 JSON document"
    • removedInput schema / properties / after / properties
      Removed value: -{
      -  "info": {
      -    "properties": {
      -      "title": {
      -        "type": "string"
      -      },
      -      "version": {
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "openapi": {
      -    "type": "string"
      -  },
      -  "paths": {
      -    "properties": {},
      -    "type": "object"
      -  }
      -}
    • addedInput schema / properties / before / description
      Added value: +"Old OpenAPI 3.0/3.1 JSON document"
    • removedInput schema / properties / before / properties
      Removed value: -{
      -  "info": {
      -    "properties": {
      -      "title": {
      -        "type": "string"
      -      },
      -      "version": {
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "openapi": {
      -    "type": "string"
      -  },
      -  "paths": {
      -    "properties": {
      -      "/users": {
      -        "properties": {
      -          "get": {
      -            "properties": {
      -              "responses": {
      -                "properties": {
      -                  "200": {
      -                    "properties": {
      -                      "description": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "type": "object"
      -                  }
      -                },
      -                "type": "object"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  }
      -}
    • addedInput schema / required
      Added value: +[
      +  "before",
      +  "after"
      +]
  6. Changed5 schema fields changed
    • removedInput schema / properties / after / description
      Removed value: -"The proposed OpenAPI 3 JSON document"
    • addedInput schema / properties / after / properties
      Added value: +{
      +  "info": {
      +    "properties": {
      +      "title": {
      +        "type": "string"
      +      },
      +      "version": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "openapi": {
      +    "type": "string"
      +  },
      +  "paths": {
      +    "properties": {},
      +    "type": "object"
      +  }
      +}
    • removedInput schema / properties / before / description
      Removed value: -"The current OpenAPI 3 JSON document"
    • addedInput schema / properties / before / properties
      Added value: +{
      +  "info": {
      +    "properties": {
      +      "title": {
      +        "type": "string"
      +      },
      +      "version": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "openapi": {
      +    "type": "string"
      +  },
      +  "paths": {
      +    "properties": {
      +      "/users": {
      +        "properties": {
      +          "get": {
      +            "properties": {
      +              "responses": {
      +                "properties": {
      +                  "200": {
      +                    "properties": {
      +                      "description": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  }
      +}
    • removedInput schema / required
      Removed value: -[
      -  "before",
      -  "after"
      -]
  7. First observed

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations at all, the description carries the full burden and does unusually well: it discloses that the call is paid ($0.01 USDC on Base, eip155:8453), that payment must be supplied via x402 in params._meta['x402/payment'], and that the endpoint is an HTTP POST. What it omits is any disclosure of failure modes — insufficient payment, invalid spec input, or payload size limits for inline JSON.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded: the diff purpose comes first, then input shape, then price and transport. Four terse clauses with no filler. The payment and HTTP details are crammed into a single run-on tail, which slightly hurts scannability but wastes nothing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, so the description is the only place the agent could learn what a 'surface diff' returns — breaking vs non-breaking changes, added/removed endpoints, field-level changes — and it says nothing about that. Payment and transport are covered thoroughly, but an agent cannot predict the response shape before paying $0.01.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and both properties already describe the before/after OpenAPI 3 documents, so the baseline is 3. The description goes beyond the schema by documenting the POST body envelope ({'before':{...},'after':{...}}) and by revealing a hidden payment parameter path (params._meta['x402/payment']) that does not appear in the input schema at all.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource: 'One-off surface diff between two OpenAPI 3 specs (before/after)', including the spec version and input modality. The word 'One-off' implicitly distinguishes it from the sibling monitor/watch tools without needing to name them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'One-off' and 'inline JSON' give clear context that this is a single synchronous comparison rather than an ongoing subscription, which is the key routing decision against api_change_check__monitor and __watch. It stops short of an explicit 'use X instead when' exclusion or stating the maximum spec size / whether URLs are accepted.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources