Upgrade to FastMCP 3

examples/server_with_access_token.py

@@ -17,7 +17,7 @@
 
 from north_mcp_python_sdk import NorthMCPServer
 
-mcp = NorthMCPServer("Access Token Demo", port=5222)
+mcp = NorthMCPServer("Access Token Demo")
 
 
 @mcp.tool()
@@ -101,4 +101,4 @@ def list_available_connectors() -> dict[str, str | int | list[str] | None]:
     print("  - email: User's email address")
     print("  - connector_access_tokens: OAuth tokens for external services")
 
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5222)

examples/server_with_auth.py

@@ -9,7 +9,7 @@
 
 from north_mcp_python_sdk import NorthMCPServer
 
-mcp = NorthMCPServer("Auth Demo", port=5222)
+mcp = NorthMCPServer("Auth Demo")
 
 
 @mcp.tool()
@@ -22,4 +22,4 @@ def add(a: int, b: int) -> int:
 
 
 if __name__ == "__main__":
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5222)

examples/server_with_citations.py

@@ -16,7 +16,7 @@
 
 from north_mcp_python_sdk import NorthMCPServer
 
-mcp = NorthMCPServer("Citations Demo", port=5222)
+mcp = NorthMCPServer("Citations Demo")
 
 
 @mcp.tool()
@@ -53,4 +53,4 @@ def search_knowledge_base(query: str) -> list[dict[str, str | dict[str, str]]]:
 
 
 if __name__ == "__main__":
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5222)

examples/server_with_context.py

@@ -12,7 +12,7 @@
 
 from north_mcp_python_sdk import NorthMCPServer, get_north_context
 
-mcp = NorthMCPServer("Context Demo", port=5222)
+mcp = NorthMCPServer("Context Demo")
 
 
 @mcp.tool()
@@ -49,4 +49,4 @@ def get_context() -> dict[str, str]:
     print("  X-North-Context-Tenant-ID: your-tenant-id")
     print("  X-North-Context-Feature-Flags: flag1,flag2")
 
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5222)

examples/server_with_custom_routes.py

@@ -17,7 +17,7 @@
 
 from north_mcp_python_sdk import NorthMCPServer
 
-mcp = NorthMCPServer("K8s Ready Server", port=5222)
+mcp = NorthMCPServer("K8s Ready Server")
 
 
 @mcp.custom_route("/ready", methods=["GET"])
@@ -58,4 +58,4 @@ def add(a: int, b: int) -> int:
     print("Protected endpoints (auth required):")
     print("  POST /mcp    - MCP protocol")
 
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5222)

examples/server_with_debug.py

@@ -14,7 +14,7 @@
 
 from north_mcp_python_sdk import NorthMCPServer
 
-mcp = NorthMCPServer("Debug Demo", port=5223, debug=True)
+mcp = NorthMCPServer("Debug Demo", debug=True)
 
 
 @mcp.tool()
@@ -69,4 +69,4 @@ def inspect_token() -> dict[str, str | int | list[str] | None]:
     print()
     print("Server running on port 5223...")
 
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5223)

examples/server_with_destructive_tools.py

@@ -14,7 +14,7 @@
 
 from north_mcp_python_sdk import NorthMCPServer
 
-mcp = NorthMCPServer("Annotated Tools Demo", port=5222)
+mcp = NorthMCPServer("Annotated Tools Demo")
 
 
 @mcp.tool(annotations=ToolAnnotations(destructiveHint=True))
@@ -36,4 +36,4 @@ def fetch_external_data(url: str) -> str:
 
 
 if __name__ == "__main__":
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5222)

examples/server_with_secret.py

@@ -23,7 +23,6 @@
 
 mcp = NorthMCPServer(
     "Secret Protected Server",
-    port=5222,
     server_secret=SERVER_SECRET,
 )
 
@@ -52,4 +51,4 @@ def protected_operation() -> dict[str, str | None]:
     print("Generate a test token with:")
     print(f'  python create_bearer_token.py --server-secret "{SERVER_SECRET}"')
 
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5222)

examples/server_with_trusted_issuers.py

@@ -22,7 +22,6 @@
 
 mcp = NorthMCPServer(
     "Verified Auth Demo",
-    port=5224,
     trusted_issuers=TRUSTED_ISSUERS,
     debug=True,
 )
@@ -72,4 +71,4 @@ def get_verified_identity() -> dict[str, str | bool | None]:
     print("Only tokens signed by these identity providers will be accepted.")
     print("Server running on port 5224...")
 
-    mcp.run(transport="streamable-http")
+    mcp.run(transport="streamable-http", port=5224)

pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "north-mcp-python-sdk"
-version = "0.3.3"
+version = "0.4.0"
 description = "Add your description here"
 readme = "README.md"
 authors = [{ name = "Raphael Cristal", email = "raphael@cohere.com" }]
 requires-python = ">=3.11"
 dependencies = [
- "fastmcp>=2.14.5,<3",
+ "fastmcp>=3.0.0,<4",
  "pyjwt[crypto]>=2.10.1",
 ]