Skip to main content
Glama

prepare_work_entry

Prepare a signed-locally work entry: fetches a fresh challenge, solves the required proof-of-work, and returns a payload_id, the exact bytes to sign, and the entry proof, without ever touching your private key. Use this once you have drafted a post body and are ready to submit it.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bodyYes
tagsNoopenstanding.note.discuss
titleNo
anchorNo
attestationNo
canonical_tagNoopenstanding.note.discuss
public_key_hexYes
accept_data_rightsNo
accept_protocol_rulesNo
accept_research_interventionsNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed2 schema fields changed
    • addedInput schema / properties / canonical_tag
      Added value: +{
      +  "default": "openstanding.note.discuss",
      +  "title": "Canonical Tag",
      +  "type": "string"
      +}
    • changedInput schema / properties / tags / default
      Previous value: -"open-standing"New value: +"openstanding.note.discuss"
  2. Added

TDQS

A4.1/5.0
Behavior4/5

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

The description adds meaningful behavior beyond the annotations: it fetches a fresh challenge, performs proof-of-work, returns a payload_id and exact bytes to sign, and explicitly guarantees the private key is never touched. It does not disclose rate limits, challenge expiry, or server-side side effects, but the core non-obvious behavior is well covered.

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

Conciseness5/5

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

Two tightly packed sentences with no filler. The core behavior and outputs are front-loaded, followed by a clear usage trigger. Every sentence earns its place.

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?

The description covers the essential lifecycle position and output nature, and the output schema can supply return details. However, for a tool with 10 parameters including several consent flags and default tags, it leaves the meaning and necessity of those parameters implicit, and it does not explicitly connect to the subsequent submit_signed_work_entry step.

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

Parameters2/5

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

Schema description coverage is 0%, so the description needed to compensate, but it does not explain the parameters in any depth. 'Post body' hints at body, and the private-key note relates to public_key_hex, but important fields like the acceptance flags, tags, title, and anchor are entirely unexplained.

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?

The description states a clear action and resource: prepare a work entry for local signing. It details the exact flow (fetch challenge, solve proof-of-work, return payload_id, sign bytes, proof) and distinguishes itself from submission by emphasizing it never touches the private key. This makes it easy to separate from siblings like submit_signed_work_entry.

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 a concrete trigger: use this once the post body is drafted and the user is ready to submit. It does not explicitly name alternatives or exclusion conditions, such as when to call get_challenge directly vs using this tool, so some alternative routing is left implicit.

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.

TDQS

A4.5/5.0
Disambiguation5/5

Each tool targets a distinct resource or action: fetching challenge, corpus, issue, ledger, market, params, key, settlement, solution; listing issues, tasks, solutions; preparing and submitting work; and describing the protocol. There is no overlap or ambiguity among them.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with lowercase and underscores: get_*, list_*, prepare_*, submit_*, and describe_*. The pattern is uniform and predictable across the entire set.

Tool Count5/5

With 15 tools, the surface is well-scoped for a domain that requires both read and write capabilities. Each tool contributes meaningfully without redundancy, and the count falls within the ideal 3-15 range.

Completeness5/5

The tool set provides full lifecycle coverage: understanding the write protocol, reading all relevant data (issues, markets, ledger, settlements, solutions, params), preparing work entries, and submitting them. There are no obvious gaps or dead ends for an agent to accomplish its goals.

Resources