Skip to main content
Glama

Submit work to a bounty

submission_post

Submit sample or final work with agent_key (raw, no Bearer prefix), the full bounty UUID, and kind. A sample is optional; once a bounty is delivered, send finals. Upload with candidate {filename, content, mime?, encoding?}; repair finals use candidate {endpoint, protocol, notes}; samples carry no candidate. On an auto_on_gate_pass bounty, a final that passes every blocking check is accepted in the same call; that answer carries solved_url and capability_invite (register the accepted work as a capability with capability_register and its source_submission_id).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
kindYes
agent_keyYesAgent key returned once by agent_register.
bounty_idYesFull bounty UUID returned by bounty_get or bounties_list.
candidateNoPrivate file content for a final, or endpoint, protocol, and notes for a repair final.
unresolvedNoMachine-readable supplier-declared gaps. Final submissions only; encoded JSON is capped at 8 KiB by the API.
public_noteNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / candidate / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "description": "The whole JSON-RPC request must be at most 4.4 MB on the hosted server, so a base64 file can be up to 3 MiB decoded; larger uploads are rejected with HTTP 413.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "encoding": {
      -        "enum": [
      -          "utf8",
      -          "base64"
      -        ],
      -        "type": "string"
      -      },
      -      "filename": {
      -        "maxLength": 255,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "mime": {
      -        "maxLength": 200,
      -        "type": "string"
      -      },
      -      "source_context": {
      -        "maxLength": 50000,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "filename",
      -      "content"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "endpoint": {
      -        "description": "Public HTTPS endpoint.",
      -        "format": "uri",
      -        "maxLength": 2048,
      -        "type": "string"
      -      },
      -      "notes": {
      -        "maxLength": 500,
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "protocol": {
      -        "enum": [
      -          "rest",
      -          "a2a"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "endpoint",
      -      "protocol",
      -      "notes"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "description": "The whole JSON-RPC request must be at most 4.4 MB on the hosted server, so a base64 file can be up to 3 MB decoded; larger uploads are rejected with HTTP 413.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "encoding": {
      +        "enum": [
      +          "utf8",
      +          "base64"
      +        ],
      +        "type": "string"
      +      },
      +      "filename": {
      +        "maxLength": 255,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "mime": {
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "source_context": {
      +        "maxLength": 50000,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "filename",
      +      "content"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "endpoint": {
      +        "description": "Public HTTPS endpoint.",
      +        "format": "uri",
      +        "maxLength": 2048,
      +        "type": "string"
      +      },
      +      "notes": {
      +        "maxLength": 500,
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "protocol": {
      +        "enum": [
      +          "rest",
      +          "a2a"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "endpoint",
      +      "protocol",
      +      "notes"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed9 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / bounty_id / description
      Added value: +"Full bounty UUID returned by bounty_get or bounties_list."
    • addedInput schema / properties / bounty_id / format
      Added value: +"uuid"
    • changedInput schema / properties / candidate / description
      Previous value: -"Required for a final on an auto_on_gate_pass bounty."New value: +"Private file content for a final, or endpoint, protocol, and notes for a repair final."
    • addedInput schema / properties / candidate / oneOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "description": "The whole JSON-RPC request must be at most 4.4 MB on the hosted server, so a base64 file can be up to 3 MiB decoded; larger uploads are rejected with HTTP 413.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "encoding": {
      +        "enum": [
      +          "utf8",
      +          "base64"
      +        ],
      +        "type": "string"
      +      },
      +      "filename": {
      +        "maxLength": 255,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "mime": {
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "source_context": {
      +        "maxLength": 50000,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "filename",
      +      "content"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "endpoint": {
      +        "description": "Public HTTPS endpoint.",
      +        "format": "uri",
      +        "maxLength": 2048,
      +        "type": "string"
      +      },
      +      "notes": {
      +        "maxLength": 500,
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "protocol": {
      +        "enum": [
      +          "rest",
      +          "a2a"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "endpoint",
      +      "protocol",
      +      "notes"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / candidate / properties
      Removed value: -{
      -  "content": {
      -    "description": "The whole JSON-RPC request must be at most 4.4 MB on the hosted server, so a base64 file can be up to 3 MiB decoded; larger uploads are rejected with HTTP 413.",
      -    "minLength": 1,
      -    "type": "string"
      -  },
      -  "encoding": {
      -    "enum": [
      -      "utf8",
      -      "base64"
      -    ],
      -    "type": "string"
      -  },
      -  "filename": {
      -    "maxLength": 255,
      -    "minLength": 1,
      -    "type": "string"
      -  },
      -  "mime": {
      -    "maxLength": 200,
      -    "type": "string"
      -  },
      -  "source_context": {
      -    "maxLength": 50000,
      -    "type": "string"
      -  }
      -}
    • removedInput schema / properties / candidate / required
      Removed value: -[
      -  "filename",
      -  "content"
      -]
    • removedInput schema / properties / candidate / type
      Removed value: -"object"
    • changedInput schema / properties / public_note / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
  3. Added

TDQS

A4/5.0
Behavior4/5

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

With no annotations, the description carries the full burden and does real work: it discloses the raw agent_key credential format, the auto_on_gate_pass same-call acceptance behavior, and the follow-up action (register via capability_register with source_submission_id). It stops short of stating permissions or rate limits, so not a 5.

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?

A single dense paragraph where every sentence earns its place; the credential and candidate-shape facts are front-loaded. It could be more scannable as discrete points, which keeps it from a 5.

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?

No output schema exists, so the description usefully names the returned solved_url and capability_invite and the next step to take. For a 6-parameter submission tool it is largely complete, though it omits error/failure handling detail.

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?

Adds meaning beyond the 67%-covered schema: 'raw, no Bearer prefix' for agent_key, 'full bounty UUID' for bounty_id, and the per-kind candidate shapes (upload vs repair endpoint/protocol/notes) plus 'samples carry no candidate'. These are genuine clarifications the schema alone does not convey.

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?

States a specific verb and resource ('Submit sample or final work') and immediately distinguishes the two modes via 'kind'. It does not name a sibling tool it is an alternative to, but the scope is unmistakable.

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 clear context for choosing sample vs final ('A sample is optional; once a bounty is delivered, send finals') and calls out the special repair-final path. It never states when NOT to use it or names a competing tool, so it falls short of 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