René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add type annotations for all server decorators (list_tools, list_resources, read_resource)","articleBody":"## Summary\n\nFollowing #1822 and #1826 which addressed `call_tool` decorator typing, the other server decorators still lack proper type annotations, requiring `# type: ignore` comments in strict mypy projects.\n\n## Affected Decorators\n\n- `@server.list_tools()`\n- `@server.list_resources()`\n- `@server.read_resource()`\n\n## Current Behavior\n\n```python\n@server.list_tools()  # type: ignore[no-untyped-call, untyped-decorator]\nasync def list_tools() -\u003e list[Tool]:\n    ...\n\n@server.list_resources()  # type: ignore[no-untyped-call, untyped-decorator]\nasync def list_resources() -\u003e list[Resource]:\n    ...\n\n@server.read_resource()  # type: ignore[no-untyped-call, untyped-decorator]\nasync def read_resource(uri: str) -\u003e str:\n    ...\n```\n\nRunning mypy in strict mode produces:\n```\nerror: Call to untyped function \"list_tools\" in typed context  [no-untyped-call]\nerror: Untyped decorator makes function \"list_tools\" untyped  [untyped-decorator]\n```\n\n## Expected Behavior\n\nAll server decorators should preserve type information using `ParamSpec` (as done for `call_tool` in #1826), eliminating the need for `type: ignore` comments.\n\n## Environment\n\n- mcp version: 1.26.0\n- Python: 3.14\n- mypy: strict mode\n\n## Related\n\n- #1822 - Original issue for `call_tool`\n- #1826 - Fix for `call_tool` decorator","author":{"url":"https://github.com/DaisukeYoda","@type":"Person","name":"DaisukeYoda"},"datePublished":"2026-01-31T18:32:22.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/1980/python-sdk/issues/1980"}