Skip to main content
Glama

Inspect V2 competition

inspect_open_competition_v2
Read-onlyIdempotent

New users start with operation=guide. Read exact mutation arguments using operation=schema and for_operation set to the desired mutation operation. Inspect the V2 Beta3 release, reviewed profiles, inventory, events, or proof-job state in the guide's order. Treat only CompetitionSettledV2 as payment evidence.

Input Schema

NameRequiredDescriptionDefault
stateNo
job_idNo
networkNo
bounty_idNo
operationNo
for_operationNoFor operation=schema only: mutation operation whose exact argument schema to read.

Output Schema

NameRequiredDescriptionDefault
flowsNo
stateNo
safetyNo
statusNo
error_codeNo
operationsNo
next_actionNo
side_effectsNo
creation_nonceNo
schema_versionNo
profile_supportNo
activation_stateNo
evidence_boundaryNo
execution_policy_hashNo
settlement_policy_hashNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "operation": {
      -        "const": "guide"
      -      }
      -    },
      -    "required": [
      -      "operation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "operation": {
      -        "const": "release"
      -      }
      -    },
      -    "required": [
      -      "operation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "operation": {
      -        "const": "profiles"
      -      }
      -    },
      -    "required": [
      -      "operation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "operation": {
      -        "const": "inventory"
      -      },
      -      "state": {
      -        "enum": [
      -          "announced",
      -          "funding",
      -          "active",
      -          "settled",
      -          "cancelled",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "operation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "bounty_id": {
      -        "pattern": "^0x[0-9a-fA-F]{64}$",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "operation": {
      -        "const": "events"
      -      }
      -    },
      -    "required": [
      -      "operation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "job_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "operation": {
      -        "const": "proof_job"
      -      }
      -    },
      -    "required": [
      -      "operation",
      -      "job_id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "network": {
      +        "description": "Defaults to base-mainnet.",
      +        "enum": [
      +          "base-mainnet",
      +          "base-sepolia",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "operation": {
      +        "const": "guide"
      +      }
      +    },
      +    "required": [
      +      "operation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "for_operation": {
      +        "enum": [
      +          "prepare_profile",
      +          "prepare_policies",
      +          "validate",
      +          "create",
      +          "fund",
      +          "quote_proof",
      +          "pay_proof",
      +          "prepare_proof",
      +          "authorize_relay",
      +          "prepare_action"
      +        ],
      +        "type": "string"
      +      },
      +      "operation": {
      +        "const": "schema"
      +      }
      +    },
      +    "required": [
      +      "operation",
      +      "for_operation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "network": {
      +        "description": "Defaults to base-mainnet.",
      +        "enum": [
      +          "base-mainnet",
      +          "base-sepolia",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "operation": {
      +        "const": "release"
      +      }
      +    },
      +    "required": [
      +      "operation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "network": {
      +        "description": "Defaults to base-mainnet.",
      +        "enum": [
      +          "base-mainnet",
      +          "base-sepolia",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "operation": {
      +        "const": "profiles"
      +      }
      +    },
      +    "required": [
      +      "operation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "network": {
      +        "description": "Defaults to base-mainnet.",
      +        "enum": [
      +          "base-mainnet",
      +          "base-sepolia",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "operation": {
      +        "const": "inventory"
      +      },
      +      "state": {
      +        "enum": [
      +          "announced",
      +          "funding",
      +          "active",
      +          "settled",
      +          "cancelled",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "operation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "bounty_id": {
      +        "pattern": "^0x[0-9a-fA-F]{64}$",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "network": {
      +        "description": "Defaults to base-mainnet.",
      +        "enum": [
      +          "base-mainnet",
      +          "base-sepolia",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "operation": {
      +        "const": "events"
      +      }
      +    },
      +    "required": [
      +      "operation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "job_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "operation": {
      +        "const": "proof_job"
      +      }
      +    },
      +    "required": [
      +      "operation",
      +      "job_id"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / for_operation
      Added value: +{
      +  "description": "For operation=schema only: mutation operation whose exact argument schema to read.",
      +  "enum": [
      +    "prepare_profile",
      +    "prepare_policies",
      +    "validate",
      +    "create",
      +    "fund",
      +    "quote_proof",
      +    "pay_proof",
      +    "prepare_proof",
      +    "authorize_relay",
      +    "prepare_action"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / operation / enum
      Previous value: -[
      -  "guide",
      -  "release",
      -  "profiles",
      -  "inventory",
      -  "events",
      -  "proof_job"
      -]New value: +[
      +  "guide",
      +  "schema",
      +  "release",
      +  "profiles",
      +  "inventory",
      +  "events",
      +  "proof_job"
      +]
  2. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the bar is lower, and the description adds real domain semantics beyond them: the guide-first sequencing rule and the constraint to 'treat only CompetitionSettledV2 as payment evidence'. It still omits any note on caching/limits, and the payment-evidence rule assumes pre-existing domain knowledge.

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?

Three dense sentences with no filler, and every sentence carries information. Front-loading is slightly off—it opens with a workflow tip rather than the tool's overall purpose, which only appears in the third sentence—but the guidance-first ordering is defensible given the title already names the tool.

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

Completeness4/5

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

Output schema exists so return formats need not be described, and annotations cover safety. For a seven-operation oneOf tool with low schema coverage, deferring detail to a guide-first workflow and a schema-reading operation is a legitimate completeness strategy, though 'in the guide's order' and the unexplained state/bounty_id/job_id params leave residual gaps.

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

Parameters3/5

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

Schema coverage is 17%, so the description must carry parameter meaning. It does explain the operation/for_operation pairing and implicitly maps all seven operation values to their outputs, but it says nothing about state, network, bounty_id, or job_id, leaving several parameters unexplained in both schema and prose.

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

Purpose4/5

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

The description names a specific read/inspect verb and enumerates the resources returned (V2 Beta3 release, reviewed profiles, inventory, events, proof-job state), plus the routing operations guide and schema. It is clear enough to distinguish from the sibling prepare_open_competition_v2 (which mutates), though it never states that contrast explicitly.

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?

Gives concrete operational guidance: 'New users start with operation=guide', read mutation argument shapes via operation=schema plus for_operation, and follow the guide's order. It does not name a sibling alternative or state when to call the sibling instead, which caps it below a 5.

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