Skip to main content
Glama

Prepare V2 action

prepare_open_competition_v2
Destructive

Use this only after inspect_open_competition_v2(operation=guide). Before each operation, read its exact arguments_schema with inspect_open_competition_v2(operation=schema, for_operation=the selected operation). Some operations return unsigned plans; quote_proof creates a hosted job, pay_proof may transfer Base USDC after explicit approval, and authorize_relay may submit a proof after explicit approval. Follow next_action and treat only CompetitionSettledV2 as payment evidence.

Input Schema

NameRequiredDescriptionDefault
argumentsYesExact argument object for the selected operation. First call inspect_open_competition_v2 with operation=schema and for_operation set to that operation; follow its arguments_schema. Never guess fields or include private keys.
operationYesExecute one ordered V2 Beta3 transition.

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. Changed4 schema fields changed
    • removedInput schema / $defs
      Removed value: -{
      -  "authorize_relay": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "authorization_deadline": {
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "proof_job_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "solver_signature": {
      -        "description": "Omit to receive exact EIP-712 typed data; include only after explicit approval and signing.",
      -        "pattern": "^0x(?:[0-9a-fA-F]{2})+$",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "proof_job_id",
      -      "authorization_deadline"
      -    ],
      -    "type": "object"
      -  },
      -  "create": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "acknowledged_risk_hash": {
      -        "description": "Copy the live release beta_risk_hash to acknowledge the exact public-beta risk bundle.",
      -        "pattern": "^0x[0-9a-fA-F]{64}$",
      -        "type": "string"
      -      },
      -      "creation_nonce": {
      -        "description": "Copy from prepare_policies; reuse only when retrying the same intended competition.",
      -        "pattern": "^0x[0-9a-fA-F]{64}$",
      -        "type": "string"
      -      },
      -      "creator": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "initial_funding": {
      -        "description": "Initial Base USDC contribution in 6-decimal base units; remaining funding can be pooled later.",
      -        "pattern": "^(0|[1-9][0-9]*)$",
      -        "type": "string"
      -      },
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "params": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "beta_risk_hash": {
      -            "description": "Copy from the live release beta_risk_hash.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "elf_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "execution_policy_hash": {
      -            "description": "Copy from prepare_policies.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "funding_deadline": {
      -            "description": "UTC Unix timestamp after which incomplete funding can be cancelled.",
      -            "minimum": 1,
      -            "type": "integer"
      -          },
      -          "journal_schema_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "keeper_reward": {
      -            "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -            "pattern": "^(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          },
      -          "metric_program_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "program_vkey": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "proof_system": {
      -            "enum": [
      -              "groth16",
      -              "plonk"
      -            ],
      -            "type": "string"
      -          },
      -          "proof_window_seconds": {
      -            "description": "Proof-entry window after canonical activation.",
      -            "minimum": 1,
      -            "type": "integer"
      -          },
      -          "score_direction": {
      -            "enum": [
      -              "higher_is_better",
      -              "lower_is_better"
      -            ],
      -            "type": "string"
      -          },
      -          "score_threshold": {
      -            "description": "Signed integer decimal string.",
      -            "pattern": "^-?(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          },
      -          "settlement_policy_hash": {
      -            "description": "Copy from prepare_policies.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "solver_reward": {
      -            "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -            "pattern": "^(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          },
      -          "source_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "verification_policy_hash": {
      -            "description": "Copy from prepare_profile.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "winner_mode": {
      -            "enum": [
      -              "first_proven",
      -              "best_score"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "solver_reward",
      -          "keeper_reward",
      -          "funding_deadline",
      -          "proof_window_seconds",
      -          "winner_mode",
      -          "score_direction",
      -          "score_threshold",
      -          "proof_system",
      -          "program_vkey",
      -          "source_hash",
      -          "elf_hash",
      -          "journal_schema_hash",
      -          "metric_program_hash",
      -          "execution_policy_hash",
      -          "verification_policy_hash",
      -          "settlement_policy_hash",
      -          "beta_risk_hash"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "creator",
      -      "creation_nonce",
      -      "acknowledged_risk_hash",
      -      "initial_funding",
      -      "params"
      -    ],
      -    "type": "object"
      -  },
      -  "fund": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "acknowledged_risk_hash": {
      -        "pattern": "^0x[0-9a-fA-F]{64}$",
      -        "type": "string"
      -      },
      -      "amount": {
      -        "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -        "pattern": "^(0|[1-9][0-9]*)$",
      -        "type": "string"
      -      },
      -      "competition_contract": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "contributor": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "contributor",
      -      "competition_contract",
      -      "amount",
      -      "acknowledged_risk_hash"
      -    ],
      -    "type": "object"
      -  },
      -  "pay_proof": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "payment_signature": {
      -        "description": "Omit on the first call to receive the exact x402 challenge; include only after explicit approval and signing.",
      -        "minLength": 1,
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "proof_job_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "proof_job_id"
      -    ],
      -    "type": "object"
      -  },
      -  "prepare_action": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "enum": [
      -          "finalize_best_score",
      -          "cancel_funding",
      -          "expire_competition",
      -          "cancel_unavailable_verifier",
      -          "withdraw_refund_for"
      -        ],
      -        "type": "string"
      -      },
      -      "caller": {
      -        "oneOf": [
      -          {
      -            "pattern": "^0x[0-9a-fA-F]{40}$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "competition_contract": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "contributor": {
      -        "description": "Required only for withdraw_refund_for; refunds always go to this contributor.",
      -        "oneOf": [
      -          {
      -            "pattern": "^0x[0-9a-fA-F]{40}$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "competition_contract",
      -      "action"
      -    ],
      -    "type": "object"
      -  },
      -  "prepare_policies": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "creation_nonce_seed": {
      -        "description": "Stable unique public seed for this intended competition. Reuse it only when retrying the same creation.",
      -        "maxLength": 256,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "execution_policy": {
      -        "description": "Complete public execution-policy JSON to commit.",
      -        "minProperties": 1,
      -        "type": "object"
      -      },
      -      "settlement_policy": {
      -        "description": "Complete public settlement-policy JSON to commit.",
      -        "minProperties": 1,
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "execution_policy",
      -      "settlement_policy",
      -      "creation_nonce_seed"
      -    ],
      -    "type": "object"
      -  },
      -  "prepare_profile": {
      -    "description": "Derive immutable fields for either reviewed built-in profile. profile_id is optional only for the legacy structured-artifact request shape.",
      -    "oneOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "network": {
      -            "description": "Defaults to base-mainnet.",
      -            "enum": [
      -              "base-mainnet",
      -              "base-sepolia",
      -              null
      -            ],
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "profile_id": {
      -            "const": "structured-artifact-metric-v1"
      -          },
      -          "requirements": {
      -            "items": {
      -              "oneOf": [
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "kind": {
      -                      "const": "utf8_contains"
      -                    },
      -                    "minimum_occurrences": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    },
      -                    "needle": {
      -                      "maxLength": 4096,
      -                      "minLength": 1,
      -                      "type": "string"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "needle",
      -                    "minimum_occurrences",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "kind": {
      -                      "const": "utf8_excludes"
      -                    },
      -                    "needle": {
      -                      "maxLength": 4096,
      -                      "minLength": 1,
      -                      "type": "string"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "needle",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "kind": {
      -                      "const": "maximum_bytes"
      -                    },
      -                    "maximum": {
      -                      "maximum": 1048576,
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "maximum",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "kind": {
      -                      "const": "json_valid"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "kind": {
      -                      "const": "json_pointer_exists"
      -                    },
      -                    "pointer": {
      -                      "type": "string"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "pointer",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "expected": {
      -                      "type": "string"
      -                    },
      -                    "kind": {
      -                      "const": "json_pointer_string_equals"
      -                    },
      -                    "pointer": {
      -                      "type": "string"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "pointer",
      -                    "expected",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "kind": {
      -                      "const": "json_array_minimum_length"
      -                    },
      -                    "minimum": {
      -                      "minimum": 0,
      -                      "type": "integer"
      -                    },
      -                    "pointer": {
      -                      "type": "string"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "pointer",
      -                    "minimum",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                }
      -              ]
      -            },
      -            "maxItems": 256,
      -            "minItems": 1,
      -            "type": "array"
      -          },
      -          "threshold": {
      -            "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -            "pattern": "^(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "threshold",
      -          "requirements"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "mode": {
      -            "enum": [
      -              "all_equal",
      -              "maximize_exact_matches",
      -              "minimize_absolute_error"
      -            ],
      -            "type": "string"
      -          },
      -          "network": {
      -            "description": "Defaults to base-mainnet.",
      -            "enum": [
      -              "base-mainnet",
      -              "base-sepolia",
      -              null
      -            ],
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "profile_id": {
      -            "const": "public-vector-metric-v1"
      -          },
      -          "threshold": {
      -            "description": "Signed integer decimal string.",
      -            "pattern": "^-?(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          },
      -          "vectors": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "expected": {
      -                  "maximum": 9223372036854776000,
      -                  "minimum": -9223372036854776000,
      -                  "type": "integer"
      -                },
      -                "weight": {
      -                  "maximum": 4294967295,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                }
      -              },
      -              "required": [
      -                "expected",
      -                "weight"
      -              ],
      -              "type": "object"
      -            },
      -            "maxItems": 10000,
      -            "minItems": 1,
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "profile_id",
      -          "mode",
      -          "threshold",
      -          "vectors"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  "prepare_proof": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "authorization_deadline": {
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "competition_contract": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "proof": {
      -        "pattern": "^0x(?:[0-9a-fA-F]{2})+$",
      -        "type": "string"
      -      },
      -      "proof_system": {
      -        "enum": [
      -          "groth16",
      -          "plonk"
      -        ],
      -        "type": "string"
      -      },
      -      "public_values": {
      -        "pattern": "^0x(?:[0-9a-fA-F]{2})+$",
      -        "type": "string"
      -      },
      -      "solver": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "solver_nonce": {
      -        "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -        "pattern": "^(0|[1-9][0-9]*)$",
      -        "type": "string"
      -      },
      -      "solver_signature": {
      -        "pattern": "^0x(?:[0-9a-fA-F]{2})+$",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "competition_contract",
      -      "solver",
      -      "solver_nonce",
      -      "proof_system",
      -      "public_values",
      -      "proof",
      -      "authorization_deadline"
      -    ],
      -    "type": "object"
      -  },
      -  "quote_proof": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "artifact_hash": {
      -        "description": "Required for public-vector and structured-artifact metrics. Omit for forward GMV; the API derives and binds the solver-specific submission hash from the attested snapshot.",
      -        "pattern": "^0x[0-9a-fA-F]{64}$",
      -        "type": "string"
      -      },
      -      "competition_contract": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "metric": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "mode": {
      -                "enum": [
      -                  "all_equal",
      -                  "maximize_exact_matches",
      -                  "minimize_absolute_error"
      -                ],
      -                "type": "string"
      -              },
      -              "threshold": {
      -                "description": "Signed integer decimal string.",
      -                "pattern": "^-?(0|[1-9][0-9]*)$",
      -                "type": "string"
      -              },
      -              "vectors": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "expected": {
      -                      "type": "integer"
      -                    },
      -                    "observed": {
      -                      "type": "integer"
      -                    },
      -                    "weight": {
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    }
      -                  },
      -                  "required": [
      -                    "expected",
      -                    "observed",
      -                    "weight"
      -                  ],
      -                  "type": "object"
      -                },
      -                "maxItems": 10000,
      -                "minItems": 1,
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "mode",
      -              "threshold",
      -              "vectors"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "artifact_utf8": {
      -                "maxLength": 1048576,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "profile_id": {
      -                "const": "structured-artifact-metric-v1"
      -              },
      -              "requirements": {
      -                "items": {
      -                  "oneOf": [
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "kind": {
      -                          "const": "utf8_contains"
      -                        },
      -                        "minimum_occurrences": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        },
      -                        "needle": {
      -                          "maxLength": 4096,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        "weight": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "kind",
      -                        "needle",
      -                        "minimum_occurrences",
      -                        "weight"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "kind": {
      -                          "const": "utf8_excludes"
      -                        },
      -                        "needle": {
      -                          "maxLength": 4096,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        "weight": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "kind",
      -                        "needle",
      -                        "weight"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "kind": {
      -                          "const": "maximum_bytes"
      -                        },
      -                        "maximum": {
      -                          "maximum": 1048576,
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        },
      -                        "weight": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "kind",
      -                        "maximum",
      -                        "weight"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "kind": {
      -                          "const": "json_valid"
      -                        },
      -                        "weight": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "kind",
      -                        "weight"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "kind": {
      -                          "const": "json_pointer_exists"
      -                        },
      -                        "pointer": {
      -                          "type": "string"
      -                        },
      -                        "weight": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "kind",
      -                        "pointer",
      -                        "weight"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "expected": {
      -                          "type": "string"
      -                        },
      -                        "kind": {
      -                          "const": "json_pointer_string_equals"
      -                        },
      -                        "pointer": {
      -                          "type": "string"
      -                        },
      -                        "weight": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "kind",
      -                        "pointer",
      -                        "expected",
      -                        "weight"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "kind": {
      -                          "const": "json_array_minimum_length"
      -                        },
      -                        "minimum": {
      -                          "minimum": 0,
      -                          "type": "integer"
      -                        },
      -                        "pointer": {
      -                          "type": "string"
      -                        },
      -                        "weight": {
      -                          "minimum": 1,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "kind",
      -                        "pointer",
      -                        "minimum",
      -                        "weight"
      -                      ],
      -                      "type": "object"
      -                    }
      -                  ]
      -                },
      -                "maxItems": 256,
      -                "minItems": 1,
      -                "type": "array"
      -              },
      -              "threshold": {
      -                "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -                "pattern": "^(0|[1-9][0-9]*)$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "profile_id",
      -              "threshold",
      -              "artifact_utf8",
      -              "requirements"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "campaign": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "ends_at": {
      -                    "minimum": 0,
      -                    "type": "integer"
      -                  },
      -                  "epoch_id": {
      -                    "items": {
      -                      "maximum": 255,
      -                      "minimum": 0,
      -                      "type": "integer"
      -                    },
      -                    "maxItems": 32,
      -                    "minItems": 32,
      -                    "type": "array"
      -                  },
      -                  "excluded_bounty_contracts": {
      -                    "items": {
      -                      "items": {
      -                        "maximum": 255,
      -                        "minimum": 0,
      -                        "type": "integer"
      -                      },
      -                      "maxItems": 20,
      -                      "minItems": 20,
      -                      "type": "array"
      -                    },
      -                    "maxItems": 4096,
      -                    "type": "array"
      -                  },
      -                  "excluded_wallets": {
      -                    "items": {
      -                      "items": {
      -                        "maximum": 255,
      -                        "minimum": 0,
      -                        "type": "integer"
      -                      },
      -                      "maxItems": 20,
      -                      "minItems": 20,
      -                      "type": "array"
      -                    },
      -                    "maxItems": 4096,
      -                    "type": "array"
      -                  },
      -                  "minimum_score_base_units": {
      -                    "minimum": 0,
      -                    "type": "integer"
      -                  },
      -                  "snapshot_attestation_threshold": {
      -                    "maximum": 255,
      -                    "minimum": 2,
      -                    "type": "integer"
      -                  },
      -                  "snapshot_attesters": {
      -                    "items": {
      -                      "items": {
      -                        "maximum": 255,
      -                        "minimum": 0,
      -                        "type": "integer"
      -                      },
      -                      "maxItems": 20,
      -                      "minItems": 20,
      -                      "type": "array"
      -                    },
      -                    "maxItems": 255,
      -                    "minItems": 2,
      -                    "type": "array"
      -                  },
      -                  "starts_at": {
      -                    "minimum": 0,
      -                    "type": "integer"
      -                  }
      -                },
      -                "required": [
      -                  "epoch_id",
      -                  "starts_at",
      -                  "ends_at",
      -                  "minimum_score_base_units",
      -                  "excluded_wallets",
      -                  "excluded_bounty_contracts",
      -                  "snapshot_attesters",
      -                  "snapshot_attestation_threshold"
      -                ],
      -                "type": "object"
      -              },
      -              "profile_id": {
      -                "const": "forward-canonical-gmv-attribution-metric-v2"
      -              },
      -              "snapshot": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "attestations": {
      -                    "items": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "signature": {
      -                          "items": {
      -                            "maximum": 255,
      -                            "minimum": 0,
      -                            "type": "integer"
      -                          },
      -                          "maxItems": 65,
      -                          "minItems": 65,
      -                          "type": "array"
      -                        },
      -                        "signer": {
      -                          "items": {
      -                            "maximum": 255,
      -                            "minimum": 0,
      -                            "type": "integer"
      -                          },
      -                          "maxItems": 20,
      -                          "minItems": 20,
      -                          "type": "array"
      -                        }
      -                      },
      -                      "required": [
      -                        "signer",
      -                        "signature"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "maxItems": 255,
      -                    "minItems": 2,
      -                    "type": "array"
      -                  },
      -                  "end_block_hash": {
      -                    "items": {
      -                      "maximum": 255,
      -                      "minimum": 0,
      -                      "type": "integer"
      -                    },
      -                    "maxItems": 32,
      -                    "minItems": 32,
      -                    "type": "array"
      -                  },
      -                  "end_safe_block": {
      -                    "minimum": 0,
      -                    "type": "integer"
      -                  },
      -                  "settlements": {
      -                    "items": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "block_number": {
      -                          "minimum": 0,
      -                          "type": "integer"
      -                        },
      -                        "bounty_contract": {
      -                          "items": {
      -                            "maximum": 255,
      -                            "minimum": 0,
      -                            "type": "integer"
      -                          },
      -                          "maxItems": 20,
      -                          "minItems": 20,
      -                          "type": "array"
      -                        },
      -                        "bounty_id": {
      -                          "items": {
      -                            "maximum": 255,
      -                            "minimum": 0,
      -                            "type": "integer"
      -                          },
      -                          "maxItems": 32,
      -                          "minItems": 32,
      -                          "type": "array"
      -                        },
      -                        "creator": {
      -                          "items": {
      -                            "maximum": 255,
      -                            "minimum": 0,
      -                            "type": "integer"
      -                          },
      -                          "maxItems": 20,
      -                          "minItems": 20,
      -                          "type": "array"
      -                        },
      -                        "funding": {
      -                          "items": {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "amount_base_units": {
      -                                "minimum": 0,
      -                                "type": "integer"
      -                              },
      -                              "contributor": {
      -                                "items": {
      -                                  "maximum": 255,
      -                                  "minimum": 0,
      -                                  "type": "integer"
      -                                },
      -                                "maxItems": 20,
      -                                "minItems": 20,
      -                                "type": "array"
      -                              }
      -                            },
      -                            "required": [
      -                              "contributor",
      -                              "amount_base_units"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          "maxItems": 256,
      -                          "minItems": 1,
      -                          "type": "array"
      -                        },
      -                        "gmv_base_units": {
      -                          "minimum": 0,
      -                          "type": "integer"
      -                        },
      -                        "log_index": {
      -                          "minimum": 0,
      -                          "type": "integer"
      -                        },
      -                        "protocol": {
      -                          "enum": [
      -                            "autonomous",
      -                            "open_competition_v1",
      -                            "open_competition_v2"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "settled_at": {
      -                          "minimum": 0,
      -                          "type": "integer"
      -                        },
      -                        "solver": {
      -                          "items": {
      -                            "maximum": 255,
      -                            "minimum": 0,
      -                            "type": "integer"
      -                          },
      -                          "maxItems": 20,
      -                          "minItems": 20,
      -                          "type": "array"
      -                        },
      -                        "transaction_hash": {
      -                          "items": {
      -                            "maximum": 255,
      -                            "minimum": 0,
      -                            "type": "integer"
      -                          },
      -                          "maxItems": 32,
      -                          "minItems": 32,
      -                          "type": "array"
      -                        }
      -                      },
      -                      "required": [
      -                        "protocol",
      -                        "bounty_contract",
      -                        "bounty_id",
      -                        "creator",
      -                        "solver",
      -                        "settled_at",
      -                        "block_number",
      -                        "transaction_hash",
      -                        "log_index",
      -                        "gmv_base_units",
      -                        "funding"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "maxItems": 4096,
      -                    "type": "array"
      -                  },
      -                  "start_block": {
      -                    "minimum": 0,
      -                    "type": "integer"
      -                  }
      -                },
      -                "required": [
      -                  "start_block",
      -                  "end_safe_block",
      -                  "end_block_hash",
      -                  "settlements",
      -                  "attestations"
      -                ],
      -                "type": "object"
      -              }
      -            },
      -            "required": [
      -              "profile_id",
      -              "campaign",
      -              "snapshot"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "relay": {
      -        "type": "boolean"
      -      },
      -      "solver": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "solver_nonce": {
      -        "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -        "pattern": "^(0|[1-9][0-9]*)$",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "competition_contract",
      -      "solver",
      -      "solver_nonce",
      -      "relay",
      -      "metric"
      -    ],
      -    "type": "object"
      -  },
      -  "validate": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "acknowledged_risk_hash": {
      -        "description": "Copy the live release beta_risk_hash to acknowledge the exact public-beta risk bundle.",
      -        "pattern": "^0x[0-9a-fA-F]{64}$",
      -        "type": "string"
      -      },
      -      "creation_nonce": {
      -        "description": "Copy from prepare_policies; reuse only when retrying the same intended competition.",
      -        "pattern": "^0x[0-9a-fA-F]{64}$",
      -        "type": "string"
      -      },
      -      "creator": {
      -        "pattern": "^0x[0-9a-fA-F]{40}$",
      -        "type": "string"
      -      },
      -      "initial_funding": {
      -        "description": "Initial Base USDC contribution in 6-decimal base units; remaining funding can be pooled later.",
      -        "pattern": "^(0|[1-9][0-9]*)$",
      -        "type": "string"
      -      },
      -      "network": {
      -        "description": "Defaults to base-mainnet.",
      -        "enum": [
      -          "base-mainnet",
      -          "base-sepolia",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "params": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "beta_risk_hash": {
      -            "description": "Copy from the live release beta_risk_hash.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "elf_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "execution_policy_hash": {
      -            "description": "Copy from prepare_policies.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "funding_deadline": {
      -            "description": "UTC Unix timestamp after which incomplete funding can be cancelled.",
      -            "minimum": 1,
      -            "type": "integer"
      -          },
      -          "journal_schema_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "keeper_reward": {
      -            "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -            "pattern": "^(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          },
      -          "metric_program_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "program_vkey": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "proof_system": {
      -            "enum": [
      -              "groth16",
      -              "plonk"
      -            ],
      -            "type": "string"
      -          },
      -          "proof_window_seconds": {
      -            "description": "Proof-entry window after canonical activation.",
      -            "minimum": 1,
      -            "type": "integer"
      -          },
      -          "score_direction": {
      -            "enum": [
      -              "higher_is_better",
      -              "lower_is_better"
      -            ],
      -            "type": "string"
      -          },
      -          "score_threshold": {
      -            "description": "Signed integer decimal string.",
      -            "pattern": "^-?(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          },
      -          "settlement_policy_hash": {
      -            "description": "Copy from prepare_policies.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "solver_reward": {
      -            "description": "Unsigned base-unit decimal string; USDC uses 6 decimals.",
      -            "pattern": "^(0|[1-9][0-9]*)$",
      -            "type": "string"
      -          },
      -          "source_hash": {
      -            "description": "Copy from the selected reviewed profiles entry.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "verification_policy_hash": {
      -            "description": "Copy from prepare_profile.",
      -            "pattern": "^0x[0-9a-fA-F]{64}$",
      -            "type": "string"
      -          },
      -          "winner_mode": {
      -            "enum": [
      -              "first_proven",
      -              "best_score"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "solver_reward",
      -          "keeper_reward",
      -          "funding_deadline",
      -          "proof_window_seconds",
      -          "winner_mode",
      -          "score_direction",
      -          "score_threshold",
      -          "proof_system",
      -          "program_vkey",
      -          "source_hash",
      -          "elf_hash",
      -          "journal_schema_hash",
      -          "metric_program_hash",
      -          "execution_policy_hash",
      -          "verification_policy_hash",
      -          "settlement_policy_hash",
      -          "beta_risk_hash"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "creator",
      -      "creation_nonce",
      -      "acknowledged_risk_hash",
      -      "initial_funding",
      -      "params"
      -    ],
      -    "type": "object"
      -  }
      -}
    • removedInput schema / allOf
      Removed value: -[
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "prepare_profile"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/prepare_profile"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "prepare_policies"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/prepare_policies"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "validate"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/validate"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "create"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/create"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "fund"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/fund"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "quote_proof"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/quote_proof"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "pay_proof"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/pay_proof"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "prepare_proof"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/prepare_proof"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "authorize_relay"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/authorize_relay"
      -        }
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "properties": {
      -        "operation": {
      -          "const": "prepare_action"
      -        }
      -      },
      -      "required": [
      -        "operation"
      -      ]
      -    },
      -    "then": {
      -      "properties": {
      -        "arguments": {
      -          "$ref": "#/$defs/prepare_action"
      -        }
      -      }
      -    }
      -  }
      -]
    • addedInput schema / properties / arguments / additionalProperties
      Added value: +true
    • changedInput schema / properties / arguments / description
      Previous value: -"Operation-specific body selected by the conditional schema. Never add guessed fields."New value: +"Exact argument object for the selected operation. First call inspect_open_competition_v2 with operation=schema and for_operation set to that operation; follow its arguments_schema. Never guess fields or include private keys."
  2. First observed

TDQS

A3.8/5.0
Behavior5/5

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

Beyond the annotations (destructiveHint, non-idempotent, openWorld), the description discloses concrete side effects: quote_proof creates a hosted job, pay_proof may transfer Base USDC, and authorize_relay may submit a proof, both after explicit approval. It also tells the agent to follow next_action and to treat only CompetitionSettledV2 as payment evidence, which the annotations cannot express.

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?

Four dense sentences, front-loaded with the prerequisite and per-operation workflow, and each sentence carries operational value. It could state the overall purpose more directly in the opening, but there is little wasted text.

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?

An output schema exists so return values need not be explained, and the description covers the prerequisite chain, high-risk operations, and the payment-evidence rule. It is nearly complete but leaves the tool's overall purpose implicit, which an agent may have to infer from the enum.

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 100%, so the schema already documents both parameters and the operation enum; the description's contribution is instruction to read the per-operation schema rather than defining fields itself. Baseline 3 applies since the structured schema does the heavy lifting.

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

Purpose3/5

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

The description routes the agent through the V2 workflow and names several operations (quote_proof, pay_proof, authorize_relay), so the resource is inferable, but it never plainly states the core purpose (preparing/executing an ordered V2 competition operation). The contrast with inspect_open_competition_v2 is clear via the prerequisite, yet the primary verb+resource is left to inference.

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?

It gives an explicit prerequisite ('Use this only after inspect_open_competition_v2(operation=guide)') and a per-operation workflow ('read its exact arguments_schema... for_operation=the selected operation'). This is strong when-to-use guidance, though it offers no alternatives or explicit when-not conditions beyond the inspect gate.

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