Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

Resolve #1139 -- Implement include_context argument in Context.sample (#1141)

Johannes Maron7966514a8623
diff --git a/docs/servers/sampling.mdx b/docs/servers/sampling.mdx
index 02a8241e9..7682d8087 100644
--- a/docs/servers/sampling.mdx
+++ b/docs/servers/sampling.mdx
@@ -137,6 +137,7 @@ async def creative_writing(topic: str, ctx: Context) -> str:
response = await ctx.sample(
messages=f"Write a creative short story about {topic}",
model_preferences="claude-3-sonnet", # Prefer a specific model
+ include_context="thisServer", # Use the server's context
temperature=0.9, # High creativity
max_tokens=1000
)
diff --git a/src/fastmcp/server/context.py b/src/fastmcp/server/context.py
index 0ed229912..6ccd93ae8 100644
--- a/src/fastmcp/server/context.py
+++ b/src/fastmcp/server/context.py
@@ -16,6 +16,7 @@ from mcp.shared.context import RequestContext
from mcp.types import (
ContentBlock,
CreateMessageResult,
+ IncludeContext,
ModelHint,
ModelPreferences,
Root,
@@ -272,6 +273,7 @@ class Context:
self,
messages: str | list[str | SamplingMessage],
system_prompt: str | None = None,
+ include_context: IncludeContext | None = None,
temperature: float | None = None,
max_tokens: int | None = None,
model_preferences: ModelPreferences | str | list[str] | None = None,
@@ -304,6 +306,7 @@ class Context:
result: CreateMessageResult = await self.session.create_message(
messages=sampling_messages,
system_prompt=system_prompt,
+ include_context=include_context,
temperature=temperature,
max_tokens=max_tokens,
model_preferences=self._parse_model_preferences(model_preferences),
diff --git a/tests/server/proxy/test_proxy_client.py b/tests/server/proxy/test_proxy_client.py
index e67e383e0..ffd17116f 100644
--- a/tests/server/proxy/test_proxy_client.py
+++ b/tests/server/proxy/test_proxy_client.py
@@ -29,6 +29,7 @@ def fastmcp_server():
result = await context.sample(
"Hello, world!",
system_prompt="You love FastMCP",
+ include_context="thisServer",
temperature=0.5,
max_tokens=100,
model_preferences="gpt-4o",