Skip to content

Base — API Reference

GroundworkersMCPServer

groundworkers.base.server

GroundworkersMCPServer

call_async(name, *args, **kwargs) async

Call a registered tool from an existing async runtime.

PromptArgument dataclass

One explicitly advertised string argument for an MCP prompt.

Errors

groundworkers.base.errors

internal_error_response(exc, *, logger, boundary)

Log an unexpected defect and return a stable, correlation-safe result.

scrub_error_message(message)

Remove common credential forms from an operator-facing error message.

Results

groundworkers.base.results

enum_value(value)

Render an enum (or a plain value) as the string a result payload carries.

Backends hand back either an enum member or an already-plain value depending on version and code path, and MCP payloads must be JSON-safe either way. None passes through so an unset field stays unset rather than becoming the string "None".

required_enum_value(value)

enum_value for a source that cannot be null.

Raises rather than returning None so a genuinely absent value fails loudly. The previous per-module copies stringified None into the literal text "None", which reached the operator as if it were a real value.