{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vqfax63qmyps","handle":"mcp-utils-msgspec","url":"https://wellknown.network/agents/mcp-utils-msgspec","links":{"self":"https://wellknown.network/agents/mcp-utils-msgspec/record.json","html":"https://wellknown.network/agents/mcp-utils-msgspec","markdown":"https://wellknown.network/agents/mcp-utils-msgspec/record.md","api":"https://wellknown.network/api/v1/agents/mcp-utils-msgspec","status":"https://wellknown.network/api/v1/agents/mcp-utils-msgspec/status","claim":"https://wellknown.network/agents/mcp-utils-msgspec/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-utils-msgspec/claim.json","badge":"https://wellknown.network/agents/mcp-utils-msgspec/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-utils-msgspec/history","tools":"https://wellknown.network/api/v1/agents/mcp-utils-msgspec/tools"},"ard":{"identifier":"urn:air::server:mcp-utils-msgspec","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-utils-msgspec","summary":"Synchronous utilities for Model Context Protocol (MCP) integration","description":"# mcp-utils-msgspec\n\nA synchronous Python utility package for building Model Context Protocol (MCP)\nservers with `msgspec`.\n\n![Tests](https://github.com/pioreactor/mcp-utils/actions/workflows/test.yml/badge.svg) ![PyPI - Version](https://img.shields.io/pypi/v/mcp-utils-msgspec)\n\nThis package targets **MCP protocol revision `2026-07-28`**. It implements the\nmodern stateless protocol: there is no `initialize` handshake, implicit MCP\nsession, or long-lived HTTP GET stream.\n\n## Features\n\n- Required `server/discover` support\n- Per-request protocol version and client capability metadata\n- Tools, prompts, resources, simple `{name}` resource templates, and completions\n- Multi-round-trip input requests and retry metadata\n- Required `resultType`, cache hints, and server identity metadata\n- Synchronous, framework-independent request handling\n- Optional validation of standard Streamable HTTP mirror headers\n- `msgspec` models for the supported server surface\n\nThe core returns either one JSON response or no response for a JSON-RPC\nnotification. It does not implement optional request-scoped SSE streams or\n`subscriptions/listen`, the tasks extension, or optional `x-mcp-header` tool\nparameter annotations.\n\n## Installation\n\n```bash\npip install mcp-utils-msgspec\n```\n\nFor development:\n\n```bash\npip install -e '.[dev]'\n```\n\nPython 3.10 or newer and `msgspec` 0.18 or newer are required. Flask and\nGunicorn are optional and only needed for the HTTP example.\n\n## Define a server\n\n```python\nfrom mcp_utils.core import MCPServer\nfrom mcp_utils.schema import GetPromptResult, Message, Role, TextContent\n\nmcp = MCPServer(\n    name=\"weather\",\n    version=\"1.0.0\",\n    instructions=\"Use get_weather for current conditions.\",\n)\n\n@mcp.tool()\ndef get_weather(city: str) -> dict[str, str]:\n    \"\"\"Return the current conditions for a city.\"\"\"\n    return {\"city\": city, \"conditions\": \"sunny\"}\n\n@mcp.prompt()\ndef weather_report(city: str) -> GetPromptResult:\n    \"\"\"Create a prompt asking for a weather report.\"\"\"\n…","publisher":{"name":"Fulfil.IO Inc, Pioreactor Inc.","url":null},"homepage":"https://github.com/pioreactor/mcp-utils","repository":"https://github.com/pioreactor/mcp-utils","version":"3.0.1","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","ai","llm"],"pricing":null,"endpoints":[{"url":"pypi:mcp-utils-msgspec","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-utils-msgspec","registry":"pypi","observedAt":"2026-11-09T19:26:21.152Z","publishedAt":"2026-08-12T21:01:49.507591Z","latestVersion":"3.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-utils-msgspec","url":"https://pypi.org/project/mcp-utils-msgspec/","firstSeenAt":"2026-09-10T05:21:42.178Z","fetchedAt":"2026-11-09T19:24:30.474Z","normalizedAt":"2026-11-09T19:24:30.474Z"}]},"firstSeenAt":"2026-09-10T05:21:42.178Z","updatedAt":"2026-11-09T19:26:21.152Z"}