From 319509336a997aa5ebda16437b624c0f9b612a6f Mon Sep 17 00:00:00 2001 From: Mason Williams Date: Thu, 4 Sep 2025 15:25:51 -0400 Subject: [PATCH 1/5] docs(mcp-server): add Smithery connection guide --- reference/mcp-server.mdx | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/reference/mcp-server.mdx b/reference/mcp-server.mdx index a033697..b5eb0ee 100644 --- a/reference/mcp-server.mdx +++ b/reference/mcp-server.mdx @@ -145,6 +145,20 @@ Click [here](goose://extension?cmd=npx&arg=-y&arg=mcp-remote&arg=https%3A%2F%2Fm } ``` +### Smithery + +You can connect directly to `https://mcp.onkernel.com/mcp`, or use Smithery as a proxy if you prefer by using its provided URL. + +- Use Smithery URL in any MCP client: + 1. Open [Smithery: Kernel](https://smithery.ai/server/kernel). + 2. Click "Get connection URL" and copy `https://server.smithery.ai/kernel/mcp`. + 3. Paste it into your MCP client's "Add server" flow. + +- Use Kernel in Smithery's Playground MCP client: + 1. Open [Smithery Playground](https://smithery.ai/playground). + 2. Click "Add servers", search for "Kernel", and add it. + 3. Sign in and authorize Kernel when prompted. + ### Others Many other MCP-capable tools accept: From b789a06e333998e8d37883c522d14a94293379b2 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 4 Sep 2025 19:26:06 +0000 Subject: [PATCH 2/5] docs: update code samples from OpenAPI --- .../openapi/delete-profiles-id_or_name.mdx | 23 ++++++++++++++ .../get-profiles-id_or_name-download.mdx | 31 +++++++++++++++++++ snippets/openapi/get-profiles-id_or_name.mdx | 26 ++++++++++++++++ snippets/openapi/get-profiles.mdx | 24 ++++++++++++++ snippets/openapi/post-profiles.mdx | 24 ++++++++++++++ 5 files changed, 128 insertions(+) create mode 100644 snippets/openapi/delete-profiles-id_or_name.mdx create mode 100644 snippets/openapi/get-profiles-id_or_name-download.mdx create mode 100644 snippets/openapi/get-profiles-id_or_name.mdx create mode 100644 snippets/openapi/get-profiles.mdx create mode 100644 snippets/openapi/post-profiles.mdx diff --git a/snippets/openapi/delete-profiles-id_or_name.mdx b/snippets/openapi/delete-profiles-id_or_name.mdx new file mode 100644 index 0000000..f114479 --- /dev/null +++ b/snippets/openapi/delete-profiles-id_or_name.mdx @@ -0,0 +1,23 @@ + +```typescript Typescript/Javascript +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', +}); + +await client.profiles.delete('id_or_name'); +``` + + +```python Python +from kernel import Kernel + +client = Kernel( + api_key="My API Key", +) +client.profiles.delete( + "id_or_name", +) +``` + diff --git a/snippets/openapi/get-profiles-id_or_name-download.mdx b/snippets/openapi/get-profiles-id_or_name-download.mdx new file mode 100644 index 0000000..c6307bd --- /dev/null +++ b/snippets/openapi/get-profiles-id_or_name-download.mdx @@ -0,0 +1,31 @@ + +```typescript Typescript/Javascript +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', +}); + +const response = await client.profiles.download('id_or_name'); + +console.log(response); + +const content = await response.blob(); +console.log(content); +``` + + +```python Python +from kernel import Kernel + +client = Kernel( + api_key="My API Key", +) +response = client.profiles.download( + "id_or_name", +) +print(response) +content = response.read() +print(content) +``` + diff --git a/snippets/openapi/get-profiles-id_or_name.mdx b/snippets/openapi/get-profiles-id_or_name.mdx new file mode 100644 index 0000000..4941e43 --- /dev/null +++ b/snippets/openapi/get-profiles-id_or_name.mdx @@ -0,0 +1,26 @@ + +```typescript Typescript/Javascript +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', +}); + +const profile = await client.profiles.retrieve('id_or_name'); + +console.log(profile.id); +``` + + +```python Python +from kernel import Kernel + +client = Kernel( + api_key="My API Key", +) +profile = client.profiles.retrieve( + "id_or_name", +) +print(profile.id) +``` + diff --git a/snippets/openapi/get-profiles.mdx b/snippets/openapi/get-profiles.mdx new file mode 100644 index 0000000..4dfc0ae --- /dev/null +++ b/snippets/openapi/get-profiles.mdx @@ -0,0 +1,24 @@ + +```typescript Typescript/Javascript +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', +}); + +const profiles = await client.profiles.list(); + +console.log(profiles); +``` + + +```python Python +from kernel import Kernel + +client = Kernel( + api_key="My API Key", +) +profiles = client.profiles.list() +print(profiles) +``` + diff --git a/snippets/openapi/post-profiles.mdx b/snippets/openapi/post-profiles.mdx new file mode 100644 index 0000000..5f13419 --- /dev/null +++ b/snippets/openapi/post-profiles.mdx @@ -0,0 +1,24 @@ + +```typescript Typescript/Javascript +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', +}); + +const profile = await client.profiles.create(); + +console.log(profile.id); +``` + + +```python Python +from kernel import Kernel + +client = Kernel( + api_key="My API Key", +) +profile = client.profiles.create() +print(profile.id) +``` + From 1efe8c598eac4415efb217754bc99dea39e28f8c Mon Sep 17 00:00:00 2001 From: Mason Williams Date: Thu, 4 Sep 2025 15:53:18 -0400 Subject: [PATCH 3/5] docs: Clarify Smithery proxy connection text --- reference/mcp-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/mcp-server.mdx b/reference/mcp-server.mdx index b5eb0ee..47af676 100644 --- a/reference/mcp-server.mdx +++ b/reference/mcp-server.mdx @@ -147,7 +147,7 @@ Click [here](goose://extension?cmd=npx&arg=-y&arg=mcp-remote&arg=https%3A%2F%2Fm ### Smithery -You can connect directly to `https://mcp.onkernel.com/mcp`, or use Smithery as a proxy if you prefer by using its provided URL. +You can connect directly to `https://mcp.onkernel.com/mcp`, or use Smithery as a proxy using its provided URL. - Use Smithery URL in any MCP client: 1. Open [Smithery: Kernel](https://smithery.ai/server/kernel). From c4f055b737d5a5355d053d562170acd2fced2b2b Mon Sep 17 00:00:00 2001 From: Mason Williams Date: Thu, 4 Sep 2025 16:26:11 -0400 Subject: [PATCH 4/5] docs(mcp-server): clarify Smithery URL copy step --- reference/mcp-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/mcp-server.mdx b/reference/mcp-server.mdx index 47af676..141d170 100644 --- a/reference/mcp-server.mdx +++ b/reference/mcp-server.mdx @@ -151,7 +151,7 @@ You can connect directly to `https://mcp.onkernel.com/mcp`, or use Smithery as a - Use Smithery URL in any MCP client: 1. Open [Smithery: Kernel](https://smithery.ai/server/kernel). - 2. Click "Get connection URL" and copy `https://server.smithery.ai/kernel/mcp`. + 2. Copy the URL from "Get connection URL". 3. Paste it into your MCP client's "Add server" flow. - Use Kernel in Smithery's Playground MCP client: From 05320321f0c274450cb9896752c8347168cef192 Mon Sep 17 00:00:00 2001 From: Mason Williams Date: Fri, 5 Sep 2025 10:46:35 -0400 Subject: [PATCH 5/5] style: Update Python comment style in example --- browsers/profiles.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/browsers/profiles.mdx b/browsers/profiles.mdx index 30961a0..75fcd1b 100644 --- a/browsers/profiles.mdx +++ b/browsers/profiles.mdx @@ -62,8 +62,8 @@ const kernelBrowser = await kernel.browsers.create({ kernel_browser = await kernel.browsers.create( profile={ "name": "profiles-demo", - // or - // "id": profile.id, + # or + # "id": profile.id, "save_changes": True, } )