new api

Author: kentcdodds

exercises/01.ping/01.problem.connect/package.json

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@modelcontextprotocol/sdk": "npm:@kentcdodds/tmp-modelcontextprotocol_sdk@1.13.1-alpha.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {

exercises/01.ping/01.solution.connect/package.json

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@modelcontextprotocol/sdk": "npm:@kentcdodds/tmp-modelcontextprotocol_sdk@1.13.1-alpha.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {

exercises/02.tools/01.problem.simple/README.mdx

@@ -13,9 +13,16 @@ static result.
 As a reminder, here's an example of a tool:
 
 ```ts
-server.tool('hello', 'Say hello', async () => {
-	return {
-		content: [{ type: 'text', text: 'Hello, world!' }],
-	}
-})
+server.registerTool(
+	'hello',
+	{
+		title: 'Hello',
+		description: 'Say hello',
+	},
+	async () => {
+		return {
+			content: [{ type: 'text', text: 'Hello, world!' }],
+		}
+	},
+)
 ```

exercises/02.tools/01.problem.simple/package.json

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@modelcontextprotocol/sdk": "npm:@kentcdodds/tmp-modelcontextprotocol_sdk@1.13.1-alpha.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {

exercises/02.tools/01.problem.simple/src/index.ts

@@ -12,9 +12,9 @@ const server = new McpServer(
 	},
 )
 
-// 🐨 add a tool to the server with the server.tool API
+// 🐨 add a tool to the server with the server.registerTool API
 // - the name should be 'add'
-// - the description should explain what it can be used to do (add one and two)
+// - the config object should include a user-facing title and an llm-facing description explaining what it can be used to do (add one and two)
 // - the callback should return a standard text response that says "one and two equals three"
 
 async function main() {

exercises/02.tools/01.solution.simple/package.json

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@modelcontextprotocol/sdk": "npm:@kentcdodds/tmp-modelcontextprotocol_sdk@1.13.1-alpha.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {

exercises/02.tools/01.solution.simple/src/index.ts

@@ -14,16 +14,23 @@ const server = new McpServer(
 	},
 )
 
-server.tool('add', 'Add one and two', async () => {
-	return {
-		content: [
-			{
-				type: 'text',
-				text: `The sum of 1 and 2 is 3.`,
-			},
-		],
-	}
-})
+server.registerTool(
+	'add',
+	{
+		title: 'Add',
+		description: 'Add one and two',
+	},
+	async () => {
+		return {
+			content: [
+				{
+					type: 'text',
+					text: `The sum of 1 and 2 is 3.`,
+				},
+			],
+		}
+	},
+)
 
 async function main() {
 	const transport = new StdioServerTransport()

exercises/02.tools/02.problem.args/README.mdx

@@ -14,10 +14,14 @@ Here's a quick example of a tool with arguments.
 ```ts
 import { z } from 'zod'
 
-server.tool(
+server.registerTool(
 	'hello',
-	'Say hello to someone',
-	{ name: z.string().describe('The name to greet') },
+	{
+		title: 'Hello',
+		description: 'Say hello to someone',
+		// llm-facing input schema (the description is for the llm)
+		inputSchema: { name: z.string().describe('The name to greet') },
+	},
 	async ({ name }) => {
 		return {
 			content: [{ type: 'text', text: `Hello, ${name}!` }],

exercises/02.tools/02.problem.args/package.json

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@modelcontextprotocol/sdk": "npm:@kentcdodds/tmp-modelcontextprotocol_sdk@1.13.1-alpha.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {

exercises/02.tools/02.problem.args/src/index.ts

@@ -14,14 +14,18 @@ const server = new McpServer(
 	},
 )
 
-server.tool(
+server.registerTool(
 	'add',
-	// 🐨 update the description to indicate this adds any two numbers
-	'Add one and two',
-	// 🐨 add an object with a firstNumber and secondNumber property
-	// 📜 These should be zod schemas https://zod.dev/
+	{
+		title: 'Add',
+		// 🐨 update the description to indicate this adds any two numbers
+		description: 'Add one and two',
+		// 🐨 add an inputSchema object with a firstNumber and secondNumber property
+		// 📜 These should be zod schemas https://zod.dev/
+		// 💯 add descriptions for the llm to know what they're for
+	},
+	// 🐨 accept an object parameter with a firstNumber and secondNumber property
 	async () => {
-		// 🐨 accept an object parameter with a firstNumber and secondNumber property
 		return {
 			content: [
 				{