fastmcp 2.6.1__tar.gz → 2.7.1__tar.gz

{fastmcp-2.6.1 → fastmcp-2.7.1}/.github/workflows/labeler.yml

@@ -7,6 +7,7 @@ jobs:
     permissions:
       contents: read
       pull-requests: write
+      issues: write
     runs-on: ubuntu-latest
     steps:
       - uses: actions/labeler@v5

{fastmcp-2.6.1 → fastmcp-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastmcp
-Version: 2.6.1
+Version: 2.7.1
 Summary: The fast, Pythonic way to build MCP servers.
 Project-URL: Homepage, https://gofastmcp.com
 Project-URL: Repository, https://github.com/jlowin/fastmcp
@@ -25,7 +25,8 @@ Requires-Dist: openapi-pydantic>=0.5.1
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: rich>=13.9.4
 Requires-Dist: typer>=0.15.2
-Requires-Dist: websockets>=14.0
+Provides-Extra: websockets
+Requires-Dist: websockets>=15.0.1; extra == 'websockets'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -61,7 +62,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("Demo 🚀")
 
-@mcp.tool()
+@mcp.tool
 def add(a: int, b: int) -> int:
     """Add two numbers"""
     return a + b
@@ -174,7 +175,7 @@ Learn more in the [**FastMCP Server Documentation**](https://gofastmcp.com/serve
 Tools allow LLMs to perform actions by executing your Python functions (sync or async). Ideal for computations, API calls, or side effects (like `POST`/`PUT`). FastMCP handles schema generation from type hints and docstrings. Tools can return various types, including text, JSON-serializable objects, and even images using the [`fastmcp.Image`](https://gofastmcp.com/servers/tools#return-values) helper.
 
 ```python
-@mcp.tool()
+@mcp.tool
 def multiply(a: float, b: float) -> float:
     """Multiplies two numbers."""
     return a * b
@@ -203,10 +204,10 @@ Learn more in the [**Resources & Templates Documentation**](https://gofastmcp.co
 
 ### Prompts
 
-Prompts define reusable message templates to guide LLM interactions. Decorate functions with `@mcp.prompt()`. Return strings or `Message` objects.
+Prompts define reusable message templates to guide LLM interactions. Decorate functions with `@mcp.prompt`. Return strings or `Message` objects.
 
 ```python
-@mcp.prompt()
+@mcp.prompt
 def summarize_request(text: str) -> str:
     """Generate a prompt asking for a summary."""
     return f"Please summarize the following text:\n\n{text}"
@@ -231,7 +232,7 @@ from fastmcp import FastMCP, Context
 
 mcp = FastMCP("My MCP Server")
 
-@mcp.tool()
+@mcp.tool
 async def process_data(uri: str, ctx: Context):
     # Log a message to the client
     await ctx.info(f"Processing {uri}...")
@@ -329,7 +330,7 @@ Learn more in the [**Composition Documentation**](https://gofastmcp.com/patterns
 
 Automatically generate FastMCP servers from existing OpenAPI specifications (`FastMCP.from_openapi()`) or FastAPI applications (`FastMCP.from_fastapi()`), instantly bringing your web APIs to the MCP ecosystem.
 
-Learn more: [**OpenAPI Integration**](https://gofastmcp.com/patterns/openapi) | [**FastAPI Integration**](https://gofastmcp.com/patterns/fastapi).
+Learn more: [**OpenAPI Integration**](https://gofastmcp.com/servers/openapi#openapi-integration) | [**FastAPI Integration**](https://gofastmcp.com/deployment/asgi#fastapi-integration).
 
 ### Authentication & Security
 
@@ -351,7 +352,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("Demo 🚀")
 
-@mcp.tool()
+@mcp.tool
 def hello(name: str) -> str:
     return f"Hello, {name}!"
 

{fastmcp-2.6.1 → fastmcp-2.7.1}/README.md

@@ -31,7 +31,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("Demo 🚀")
 
-@mcp.tool()
+@mcp.tool
 def add(a: int, b: int) -> int:
     """Add two numbers"""
     return a + b
@@ -144,7 +144,7 @@ Learn more in the [**FastMCP Server Documentation**](https://gofastmcp.com/serve
 Tools allow LLMs to perform actions by executing your Python functions (sync or async). Ideal for computations, API calls, or side effects (like `POST`/`PUT`). FastMCP handles schema generation from type hints and docstrings. Tools can return various types, including text, JSON-serializable objects, and even images using the [`fastmcp.Image`](https://gofastmcp.com/servers/tools#return-values) helper.
 
 ```python
-@mcp.tool()
+@mcp.tool
 def multiply(a: float, b: float) -> float:
     """Multiplies two numbers."""
     return a * b
@@ -173,10 +173,10 @@ Learn more in the [**Resources & Templates Documentation**](https://gofastmcp.co
 
 ### Prompts
 
-Prompts define reusable message templates to guide LLM interactions. Decorate functions with `@mcp.prompt()`. Return strings or `Message` objects.
+Prompts define reusable message templates to guide LLM interactions. Decorate functions with `@mcp.prompt`. Return strings or `Message` objects.
 
 ```python
-@mcp.prompt()
+@mcp.prompt
 def summarize_request(text: str) -> str:
     """Generate a prompt asking for a summary."""
     return f"Please summarize the following text:\n\n{text}"
@@ -201,7 +201,7 @@ from fastmcp import FastMCP, Context
 
 mcp = FastMCP("My MCP Server")
 
-@mcp.tool()
+@mcp.tool
 async def process_data(uri: str, ctx: Context):
     # Log a message to the client
     await ctx.info(f"Processing {uri}...")
@@ -299,7 +299,7 @@ Learn more in the [**Composition Documentation**](https://gofastmcp.com/patterns
 
 Automatically generate FastMCP servers from existing OpenAPI specifications (`FastMCP.from_openapi()`) or FastAPI applications (`FastMCP.from_fastapi()`), instantly bringing your web APIs to the MCP ecosystem.
 
-Learn more: [**OpenAPI Integration**](https://gofastmcp.com/patterns/openapi) | [**FastAPI Integration**](https://gofastmcp.com/patterns/fastapi).
+Learn more: [**OpenAPI Integration**](https://gofastmcp.com/servers/openapi#openapi-integration) | [**FastAPI Integration**](https://gofastmcp.com/deployment/asgi#fastapi-integration).
 
 ### Authentication & Security
 
@@ -321,7 +321,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("Demo 🚀")
 
-@mcp.tool()
+@mcp.tool
 def hello(name: str) -> str:
     return f"Hello, {name}!"
 

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/clients/auth/bearer.mdx

@@ -3,6 +3,7 @@ title: Bearer Token Authentication
 sidebarTitle: Bearer Auth
 description: Authenticate your FastMCP client with a Bearer token.
 icon: key
+tag: "New!"
 ---
 
 import { VersionBadge } from "/snippets/version-badge.mdx"

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/clients/auth/oauth.mdx

@@ -3,6 +3,7 @@ title: OAuth Authentication
 sidebarTitle: OAuth
 description: Authenticate your FastMCP client via OAuth 2.1.
 icon: window
+tag: "New!"
 ---
 
 import { VersionBadge } from "/snippets/version-badge.mdx"

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/clients/transports.mdx

@@ -359,7 +359,7 @@ import asyncio
 # 1. Create your FastMCP server instance
 server = FastMCP(name="InMemoryServer")
 
-@server.tool()
+@server.tool
 def ping(): 
     return "pong"
 

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/deployment/asgi.mdx

@@ -32,7 +32,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("MyServer")
 
-@mcp.tool()
+@mcp.tool
 def hello(name: str) -> str:
     return f"Hello, {name}!"
 

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/deployment/running-server.mdx

@@ -22,7 +22,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP(name="MyServer")
 
-@mcp.tool()
+@mcp.tool
 def hello(name: str) -> str:
     return f"Hello, {name}!"
 
@@ -61,6 +61,17 @@ fastmcp dev server.py
 
 See the [CLI documentation](/patterns/cli) for detailed information about all available commands and options.
 
+### Passing Arguments to Servers
+
+When servers accept command line arguments (using argparse, click, or other libraries), you can pass them after `--`:
+
+```bash
+fastmcp run config_server.py -- --config config.json
+fastmcp run database_server.py -- --database-path /tmp/db.sqlite --debug
+```
+
+This is useful for servers that need configuration files, database paths, API keys, or other runtime options.
+
 ## Transport Options
 
 Below is a comparison of available transport options to help you choose the right one for your needs:
@@ -233,7 +244,7 @@ import asyncio
 
 mcp = FastMCP(name="MyServer")
 
-@mcp.tool()
+@mcp.tool
 def hello(name: str) -> str:
     return f"Hello, {name}!"
 
@@ -270,4 +281,4 @@ async def health_check(request: Request) -> PlainTextResponse:
 
 if __name__ == "__main__":
     mcp.run()
-```
+```

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/docs.json

@@ -11,11 +11,22 @@
         },
         "decoration": "windows"
     },
+    "banner": {
+        "content": "[FastMCP Cloud](https://fastmcp.link/x0Kyhy2) is coming!"
+    },
     "colors": {
         "dark": "#f72585",
         "light": "#4cc9f0",
         "primary": "#2d00f7"
     },
+    "contextual": {
+        "options": [
+            "copy",
+            "view",
+            "chatgpt",
+            "claude"
+        ]
+    },
     "description": "The fast, Pythonic way to build MCP servers and clients.",
     "favicon": {
         "dark": "/assets/favicon.ico",
@@ -47,7 +58,8 @@
                 "pages": [
                     "getting-started/welcome",
                     "getting-started/installation",
-                    "getting-started/quickstart"
+                    "getting-started/quickstart",
+                    "updates"
                 ]
             },
             {

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/getting-started/quickstart.mdx

@@ -32,7 +32,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("My MCP Server")
 
-@mcp.tool()
+@mcp.tool
 def greet(name: str) -> str:
     return f"Hello, {name}!"
 ```
@@ -49,7 +49,7 @@ from fastmcp import FastMCP, Client
 
 mcp = FastMCP("My MCP Server")
 
-@mcp.tool()
+@mcp.tool
 def greet(name: str) -> str:
     return f"Hello, {name}!"
 
@@ -76,7 +76,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("My MCP Server")
 
-@mcp.tool()
+@mcp.tool
 def greet(name: str) -> str:
     return f"Hello, {name}!"
 

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/getting-started/welcome.mdx

@@ -14,7 +14,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("Demo 🚀")
 
-@mcp.tool()
+@mcp.tool
 def add(a: int, b: int) -> int:
     """Add two numbers"""
     return a + b

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/integrations/anthropic.mdx

@@ -3,6 +3,7 @@ title: Anthropic
 sidebarTitle: Anthropic
 description: Call FastMCP servers from the Anthropic API
 icon: message-smile
+tag: "New!"
 ---
 
 import { VersionBadge } from "/snippets/version-badge.mdx"
@@ -27,7 +28,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP(name="Dice Roller")
 
-@mcp.tool()
+@mcp.tool
 def roll_dice(n_dice: int) -> list[int]:
     """Roll `n_dice` 6-sided dice and return the results."""
     return [random.randint(1, 6) for _ in range(n_dice)]
@@ -170,7 +171,7 @@ auth = BearerAuthProvider(
 
 mcp = FastMCP(name="Dice Roller", auth=auth)
 
-@mcp.tool()
+@mcp.tool
 def roll_dice(n_dice: int) -> list[int]:
     """Roll `n_dice` 6-sided dice and return the results."""
     return [random.randint(1, 6) for _ in range(n_dice)]

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/integrations/claude-desktop.mdx

@@ -31,7 +31,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP(name="Dice Roller")
 
-@mcp.tool()
+@mcp.tool
 def roll_dice(n_dice: int) -> list[int]:
     """Roll `n_dice` 6-sided dice and return the results."""
     return [random.randint(1, 6) for _ in range(n_dice)]

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/integrations/contrib.mdx

@@ -12,7 +12,7 @@ FastMCP includes a `contrib` package that holds community-contributed modules. T
 
 Contrib modules provide additional features, integrations, or patterns that complement the core FastMCP library. They offer a way for the community to share useful extensions while keeping the core library focused and maintainable.
 
-The available modules can be viewed in the [contrib directory](https://github.com/jlowin/fastmcp/tree/main/src/contrib).
+The available modules can be viewed in the [contrib directory](https://github.com/jlowin/fastmcp/tree/main/src/fastmcp/contrib).
 
 ## Usage
 

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/integrations/gemini.mdx

@@ -3,6 +3,7 @@ title: Gemini SDK
 sidebarTitle: Gemini SDK
 description: Call FastMCP servers from the Google Gemini SDK
 icon: message-smile
+tag: "New!"
 ---
 
 import { VersionBadge } from "/snippets/version-badge.mdx"
@@ -31,7 +32,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP(name="Dice Roller")
 
-@mcp.tool()
+@mcp.tool
 def roll_dice(n_dice: int) -> list[int]:
     """Roll `n_dice` 6-sided dice and return the results."""
     return [random.randint(1, 6) for _ in range(n_dice)]
@@ -66,7 +67,7 @@ mcp_client = Client("server.py")
 gemini_client = genai.Client()
 
 async def main():    
-    async with client:
+    async with mcp_client:
         response = await gemini_client.aio.models.generate_content(
             model="gemini-2.0-flash",
             contents="Roll 3 dice!",

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/integrations/openai.mdx

@@ -3,6 +3,7 @@ title: OpenAI
 sidebarTitle: OpenAI
 description: Call FastMCP servers from the OpenAI API
 icon: message-smile
+tag: "New!"
 ---
 
 import { VersionBadge } from "/snippets/version-badge.mdx"
@@ -32,7 +33,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP(name="Dice Roller")
 
-@mcp.tool()
+@mcp.tool
 def roll_dice(n_dice: int) -> list[int]:
     """Roll `n_dice` 6-sided dice and return the results."""
     return [random.randint(1, 6) for _ in range(n_dice)]
@@ -165,7 +166,7 @@ auth = BearerAuthProvider(
 
 mcp = FastMCP(name="Dice Roller", auth=auth)
 
-@mcp.tool()
+@mcp.tool
 def roll_dice(n_dice: int) -> list[int]:
     """Roll `n_dice` 6-sided dice and return the results."""
     return [random.randint(1, 6) for _ in range(n_dice)]

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/patterns/cli.mdx

@@ -66,7 +66,7 @@ from fastmcp import FastMCP
 
 mcp = FastMCP("MyServer")
 
-@mcp.tool()
+@mcp.tool
 def hello(name: str) -> str:
     return f"Hello, {name}!"
 

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/patterns/decorating-methods.mdx

@@ -5,22 +5,47 @@ description: Properly use instance methods, class methods, and static methods wi
 icon: at
 ---
 
-FastMCP's decorator system is designed to work with functions, but you may see unexpected behavior if you try to decorate an instance or class method. This guide explains the correct approach for using methods with all FastMCP decorators (`@tool()`, `@resource()`, and `@prompt()`).
+FastMCP's decorator system is designed to work with functions, but you may see unexpected behavior if you try to decorate an instance or class method. This guide explains the correct approach for using methods with all FastMCP decorators (`@tool`, `@resource`, and `.prompt`).
 
 ## Why Are Methods Hard?
 
-When you apply a FastMCP decorator like `@tool()`, `@resource()`, or `@prompt()` to a method, the decorator captures the function at decoration time. For instance methods and class methods, this poses a challenge because:
+When you apply a FastMCP decorator like `@tool`, `@resource`, or `@prompt` to a method, the decorator captures the function at decoration time. For instance methods and class methods, this poses a challenge because:
 
 1. For instance methods: The decorator gets the unbound method before any instance exists
 2. For class methods: The decorator gets the function before it's bound to the class
 
 This means directly decorating these methods doesn't work as expected. In practice, the LLM would see parameters like `self` or `cls` that it cannot provide values for.
 
+Additionally, **FastMCP decorators return objects (Tool, Resource, or Prompt instances) rather than the original function**. This means that when you decorate a method directly, the method becomes the returned object and is no longer callable by your code:
+
+<Warning>
+**Don't do this!**
+
+The method will no longer be callable from Python, and the tool won't be callable by LLMs.
+
+```python
+
+from fastmcp import FastMCP
+mcp = FastMCP()
+
+class MyClass:
+    @mcp.tool
+    def my_method(self, x: int) -> int:
+        return x * 2
+
+obj = MyClass()
+obj.my_method(5)  # Fails - my_method is a Tool, not a function
+```
+</Warning>
+
+This is another important reason to register methods functionally after defining the class.
+
 ## Recommended Patterns
 
 ### Instance Methods
 
-**Don't do this** (it doesn't work properly):
+<Warning>
+**Don't do this!**
 
 ```python
 from fastmcp import FastMCP
@@ -28,17 +53,14 @@ from fastmcp import FastMCP
 mcp = FastMCP()
 
 class MyClass:
-    @mcp.tool()  # This won't work correctly
+    @mcp.tool  # This won't work correctly
     def add(self, x, y):
         return x + y
-    
-    @mcp.resource("resource://{param}")  # This won't work correctly
-    def get_resource(self, param: str):
-        return f"Resource data for {param}"
 ```
-
+</Warning>
 When the decorator is applied this way, it captures the unbound method. When the LLM later tries to use this component, it will see `self` as a required parameter, but it won't know what to provide for it, causing errors or unexpected behavior.
 
+<Check>
 **Do this instead**:
 
 ```python
@@ -49,21 +71,15 @@ mcp = FastMCP()
 class MyClass:
     def add(self, x, y):
         return x + y
-    
-    def get_resource(self, param: str):
-        return f"Resource data for {param}"
 
-# Create an instance first, then add the bound methods
+# Create an instance first, then register the bound methods
 obj = MyClass()
-mcp.add_tool(obj.add)
-mcp.add_resource_fn(obj.get_resource, uri="resource://{param}")  # For resources or templates
-
-# Note: FastMCP provides add_resource() for adding Resource objects directly and
-# add_resource_fn() for adding functions that generate resources or templates
+mcp.tool(obj.add)
 
 # Now you can call it without 'self' showing up as a parameter
-await mcp.call_tool('add', {'x': 1, 'y': 2})  # Returns 3
+await mcp._mcp_call_tool('add', {'x': 1, 'y': 2})  # Returns 3
 ```
+</Check>
 
 This approach works because:
 1. You first create an instance of the class (`obj`)
@@ -72,9 +88,10 @@ This approach works because:
 
 ### Class Methods
 
-Similar to instance methods, decorating class methods directly doesn't work properly:
+The behavior of decorating class methods depends on the order of decorators:
 
-**Don't do this**:
+<Warning>
+**Don't do this** (decorator order matters):
 
 ```python
 from fastmcp import FastMCP
@@ -83,13 +100,21 @@ mcp = FastMCP()
 
 class MyClass:
     @classmethod
-    @mcp.tool()  # This won't work correctly
-    def from_string(cls, s):
+    @mcp.tool  # This won't work but won't raise an error
+    def from_string_v1(cls, s):
+        return cls(s)
+    
+    @mcp.tool
+    @classmethod  # This will raise a helpful ValueError
+    def from_string_v2(cls, s):
         return cls(s)
 ```
+</Warning>
 
-The problem here is that the FastMCP decorator is applied before the `@classmethod` decorator (Python applies decorators bottom-to-top). So it captures the function before it's transformed into a class method, leading to incorrect behavior.
+- If `@classmethod` comes first, then `@mcp.tool`: No error is raised, but it won't work correctly
+- If `@mcp.tool` comes first, then `@classmethod`: FastMCP will detect this and raise a helpful `ValueError` with guidance
 
+<Check>
 **Do this instead**:
 
 ```python
@@ -102,9 +127,10 @@ class MyClass:
     def from_string(cls, s):
         return cls(s)
 
-# Add the class method after the class is defined
-mcp.add_tool(MyClass.from_string)
+# Register the class method after the class is defined
+mcp.tool(MyClass.from_string)
 ```
+</Check>
 
 This works because:
 1. The `@classmethod` decorator is applied properly during class definition
@@ -113,7 +139,10 @@ This works because:
 
 ### Static Methods
 
-Unlike instance and class methods, static methods work fine with FastMCP decorators:
+Static methods "work" with FastMCP decorators, but this is not recommended because the FastMCP decorator will not return a callable method. Therefore, you should register static methods the same way as other methods.
+
+<Warning>
+**This is not recommended, though it will work.**
 
 ```python
 from fastmcp import FastMCP
@@ -121,23 +150,17 @@ from fastmcp import FastMCP
 mcp = FastMCP()
 
 class MyClass:
+    @mcp.tool
     @staticmethod
-    @mcp.tool()  # This works!
     def utility(x, y):
         return x + y
-    
-    @staticmethod
-    @mcp.resource("resource://data")  # This works too!
-    def get_data():
-        return "Static resource data"
 ```
+</Warning>
 
-This approach works because:
-1. The `@staticmethod` decorator is applied first (executed last), transforming the method into a regular function
-2. When the FastMCP decorator is applied, it's capturing what is effectively just a regular function
-3. A static method doesn't have any binding requirements - it doesn't receive a `self` or `cls` parameter
+This works because `@staticmethod` converts the method to a regular function, which the FastMCP decorator can then properly process. However, this is not recommended because the FastMCP decorator will not return a callable staticmethod. Therefore, you should register static methods the same way as other methods.
 
-Alternatively, you can use the same pattern as the other methods:
+<Check>
+**Prefer this pattern:**
 
 ```python
 from fastmcp import FastMCP
@@ -150,10 +173,9 @@ class MyClass:
         return x + y
 
 # This also works
-mcp.add_tool(MyClass.utility)
+mcp.tool(MyClass.utility)
 ```
-
-This works for the same reason - a static method is essentially just a function in a class namespace.
+</Check>
 
 ## Additional Patterns
 
@@ -169,8 +191,8 @@ mcp = FastMCP()
 class ComponentProvider:
     def __init__(self, mcp_instance):
         # Register methods
-        mcp_instance.add_tool(self.tool_method)
-        mcp_instance.add_resource_fn(self.resource_method, uri="resource://data")
+        mcp_instance.tool(self.tool_method)
+        mcp_instance.resource("resource://data")(self.resource_method)
     
     def tool_method(self, x):
         return x * 2
@@ -191,11 +213,13 @@ The class automatically registers its methods during initialization, ensuring th
 
 ## Summary
 
-While FastMCP's decorator pattern works seamlessly with regular functions and static methods, for instance methods and class methods, you should add them after creating the instance or class. This ensures that the methods are properly bound before being registered.
+The current behavior of FastMCP decorators with methods is:
+
+- **Static methods**: Can be decorated directly and work perfectly with all FastMCP decorators
+- **Class methods**: Cannot be decorated directly and will raise a helpful `ValueError` with guidance
+- **Instance methods**: Should be registered after creating an instance using the decorator calls
+
+For class and instance methods, you should register them after creating the instance or class to ensure proper method binding. This ensures that the methods are properly bound before being registered.
 
-These patterns apply to all FastMCP decorators and registration methods:
-- `@tool()` and `add_tool()`
-- `@resource()` and `add_resource_fn()`
-- `@prompt()` and `add_prompt()`
 
-Understanding these patterns allows you to effectively organize your components into classes while maintaining proper method binding, giving you the benefits of object-oriented design without sacrificing the simplicity of FastMCP's decorator system.
+Understanding these patterns allows you to effectively organize your components into classes while maintaining proper method binding, giving you the benefits of object-oriented design without sacrificing the simplicity of FastMCP's decorator system.

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/patterns/http-requests.mdx

@@ -25,7 +25,7 @@ from starlette.requests import Request
 
 mcp = FastMCP(name="HTTP Request Demo")
 
-@mcp.tool()
+@mcp.tool
 async def user_agent_info() -> dict:
     """Return information about the user agent."""
     # Get the HTTP request
@@ -58,7 +58,7 @@ from fastmcp.server.dependencies import get_http_headers
 
 mcp = FastMCP(name="Headers Demo")
 
-@mcp.tool()
+@mcp.tool
 async def safe_header_info() -> dict:
     """Safely get header information without raising errors."""
     # Get headers (returns empty dict if no request context)

{fastmcp-2.6.1 → fastmcp-2.7.1}/docs/patterns/testing.mdx

@@ -22,7 +22,7 @@ from fastmcp import FastMCP, Client
 def mcp_server():
     server = FastMCP("TestServer")
     
-    @server.tool()
+@server.tool
     def greet(name: str) -> str:
         return f"Hello, {name}!"