Skip to content

runtime-surface.md

Latest commit

 

History

History
102 lines (73 loc) · 2.9 KB

runtime-surface.md

File metadata and controls

102 lines (73 loc) · 2.9 KB

Runtime Surface

pymcp-kit keeps the built-in surface intentionally narrow. This page is the quickest way to see what the package exposes at runtime and what capability toggles affect the MCP handshake.

Supported Protocol Versions

ServerSettings.protocol_versions currently defaults to:

  • 2025-11-25
  • 2025-06-18
  • 2025-03-26
  • 2024-11-05

Built-In HTTP Endpoints

  • GET /: basic server metadata
  • POST /mcp: Streamable HTTP MCP endpoint
  • GET /mcp: transport support endpoint for streamable sessions
  • DELETE /mcp: session termination endpoint for streamable sessions

Implemented MCP Methods

Lifecycle

  • initialize
  • ping
  • notifications/initialized
  • notifications/cancelled

Tools

  • tools/list
  • tools/call

Prompts

  • prompts/list
  • prompts/get

Resources

  • resources/list
  • resources/read
  • resources/subscribe
  • resources/unsubscribe
  • notifications/resources/updated

Roots

  • roots/list

Tasks

  • tasks/list
  • tasks/get
  • tasks/cancel
  • tasks/result
  • notifications/tasks/status
  • notifications/progress

Capability Settings

CapabilitySettings controls which fragments appear in initialize.result.capabilities and which optional runtime behaviors are enabled.

Setting Default Effect
tools_list_changed False Advertise tools.listChanged support.
prompts_list_changed False Advertise prompts.listChanged support.
resources_list_changed False Advertise resources.listChanged support.
resources_subscribe True Advertise and enable resource subscription support.
advertise_empty_prompts False Expose a prompts capability even when no prompts are registered.
advertise_empty_resources False Expose a resources capability even when no resources are registered.
roots_enabled True Expose roots capability and handler.
roots_list_changed False Advertise roots.listChanged support.
tasks_enabled True Expose task capability fragments and task handlers.
tasks_tool_call True Advertise task augmentation for tools/call.
tasks_list True Advertise the tasks/list capability fragment.
tasks_cancel True Advertise the tasks/cancel capability fragment.
elicitation_form True Advertise form-based elicitation support.
elicitation_url False Advertise URL-based elicitation support.

Server Metadata

By default, ServerSettings() uses:

ServerSettings(
    name="pymcp-kit",
    version="0.1.0",
)

Those defaults flow into both:

  • the HTTP root payload returned from GET /
  • initialize.result.serverInfo

Current Non-Goals

  • SSE and HTTP NDJSON transports are intentionally not bundled
  • metrics and tracing are not part of the shipped surface
  • the package focuses on a practical MCP server core rather than a full framework stack