diff --git a/.eslintignore b/.eslintignore
index 25aee502..f3af2557 100644
--- a/.eslintignore
+++ b/.eslintignore
@@ -3,6 +3,6 @@ dist
 coverage 
 *.log 
 **/*.js 
-packages/client/src/remote-dom/iframe-bundle.ts
+sdks/typescript/client/src/remote-dom/iframe-bundle.ts
 
 examples
\ No newline at end of file
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index efb0938e..6ee80eed 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -7,26 +7,48 @@ on:
   pull_request:
     branches:
       - main
+  release:
+    types: [published]
 
 jobs:
-  build_lint_test:
+  filter_changed_paths:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [22.x]
+    outputs:
+      ts_client_files: ${{ steps.filter.outputs.ts_client_files }}
+      ts_server_files: ${{ steps.filter.outputs.ts_server_files }}
+      ruby_sdk_files: ${{ steps.filter.outputs.ruby_sdk_files }}
+      example_files: ${{ steps.filter.outputs.example_files }}
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v2
+        id: filter
+        with:
+          filters: |
+            ts_client_files:
+              - 'sdks/typescript/client/**'
+            ts_server_files:
+              - 'sdks/typescript/server/**'
+            ruby_sdk_files:
+              - 'sdks/ruby/**'
+            example_files:
+              - 'examples/**'
+
+  js_build_and_test:
+    needs: filter_changed_paths
+    if: needs.filter_changed_paths.outputs.ts_client_files == 'true' || needs.filter_changed_paths.outputs.ts_server_files == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
           version: 10
 
-      - name: Setup Node.js ${{ matrix.node-version }}
+      - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node-version }}
+          node-version: 22.x
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -36,30 +58,17 @@ jobs:
         run: pnpm lint
 
       - name: Test
-        run: pnpm test
-
-      - name: Build libraries (excluding docs)
-        run: pnpm --filter=!@mcp-ui/docs build
+        run: pnpm test:ts
 
-      - name: Build docs
-        if: matrix.node-version == '20.x' # Build docs only on one Node version to save time
-        run: pnpm --filter=@mcp-ui/docs build
+      - name: Build
+        run: pnpm build
 
-  publish:
-    needs: build_lint_test
+  ruby_sdk_test:
+    needs: filter_changed_paths
+    if: needs.filter_changed_paths.outputs.ruby_sdk_files == 'true'
     runs-on: ubuntu-latest
-    # Run on pushes to the main branch. semantic-release will determine if a release is needed.
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main' && !startsWith(github.head_commit.message, 'chore(release):') && !(contains(join(github.event.commits.*.files_changed, ','), 'examples/') || contains(join(github.event.commits.*.files_changed, ','), 'docs/'))
-    permissions:
-      contents: write # Needed to push new version tags, commit changelog/package.json updates
-      issues: write # Needed to create/comment on release-related issues (optional, but good practice)
-      id-token: write # Required for publishing to NPM with OIDC
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          # Fetch all history for all tags and branches so semantic-release can analyze commits
-          fetch-depth: 0
+      - uses: actions/checkout@v4
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
@@ -69,29 +78,110 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 22.x # Use a Node version compatible with semantic-release
+          node-version: 22.x
           cache: 'pnpm'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Build all packages
-        run: pnpm --filter="./packages/*" build
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler: latest
+          bundler-cache: true
+          working-directory: 'sdks/ruby'
 
-      - name: List contents of client dist
-        run: |
-          echo "--- Listing packages/client/dist ---"
-          ls -R packages/client/dist || echo "packages/client/dist not found or empty"
-          echo "--- End of packages/client/dist ---"
+      - name: Lint
+        run: bundle exec rubocop
+        working-directory: 'sdks/ruby'
 
-      - name: List contents of server dist
-        run: |
-          echo "--- Listing packages/server/dist ---"
-          ls -R packages/server/dist || echo "packages/server/dist not found or empty"
-          echo "--- End of packages/server/dist ---"
+      - name: Run tests
+        run: pnpm test:ruby
+
+  release_ts_client:
+    needs: [js_build_and_test]
+    if: github.ref == 'refs/heads/main' && needs.filter_changed_paths.outputs.ts_client_files == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with: { version: 10 }
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with: { node-version: 22.x, cache: 'pnpm' }
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Release
+        working-directory: sdks/typescript/client
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release
 
-      - name: Semantic Release
+  release_ts_server:
+    needs: [js_build_and_test]
+    if: github.ref == 'refs/heads/main' && needs.filter_changed_paths.outputs.ts_server_files == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with: { version: 10 }
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with: { node-version: 22.x, cache: 'pnpm' }
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Release
+        working-directory: sdks/typescript/server
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Provided by Actions, used by @semantic-release/github and @semantic-release/git
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }} # Your NPM token, used by @semantic-release/npm
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: npx semantic-release
+
+  release_ruby_sdk:
+    name: Release Ruby SDK
+    needs: [ruby_sdk_test]
+    if: github.ref == 'refs/heads/main' && needs.filter_changed_paths.outputs.ruby_sdk_files == 'true'
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: write # to push commits and tags
+      id-token: write # for trusted publishing
+      issues: write # to comment on issues
+      pull-requests: write # to comment on pull requests
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with: { version: 10 }
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with: { node-version: 22.x, cache: 'pnpm' }
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler: latest
+          bundler-cache: true
+          working-directory: sdks/ruby
+      - name: Release
+        working-directory: sdks/ruby
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx semantic-release
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index 5a2e9210..afb19e9d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -132,10 +132,10 @@ docs/src/.vitepress/dist
 docs/src/.vitepress/cache
 
 # Monorepo specific
-/packages/**/dist
-/packages/**/coverage
-/apps/**/dist
-/apps/**/coverage
+/sdks/**/dist
+/sdks/**/coverage
+/examples/**/dist
+/examples/**/coverage
 
 # OS generated files #
 ######################
diff --git a/.releaserc.json b/.releaserc.json
index c41e309e..ad730909 100644
--- a/.releaserc.json
+++ b/.releaserc.json
@@ -7,14 +7,14 @@
     [
       "@semantic-release/npm",
       {
-        "pkgRoot": "packages/client",
+        "pkgRoot": "sdks/typescript/client",
         "npmPublish": true
       }
     ],
     [
       "@semantic-release/npm",
       {
-        "pkgRoot": "packages/server",
+        "pkgRoot": "sdks/typescript/server",
         "npmPublish": true
       }
     ],
@@ -36,8 +36,8 @@
         "assets": [
           "CHANGELOG.md",
           "package.json",
-          "packages/client/package.json",
-          "packages/server/package.json",
+          "sdks/typescript/client/package.json",
+          "sdks/typescript/server/package.json",
           "pnpm-lock.yaml"
         ],
         "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
diff --git a/.ruby-version b/.ruby-version
new file mode 100644
index 00000000..be94e6f5
--- /dev/null
+++ b/.ruby-version
@@ -0,0 +1 @@
+3.2.2
diff --git a/README.md b/README.md
index 8ad0da8f..f44601f1 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/@mcp-ui/server"><img src="https://img.shields.io/npm/v/@mcp-ui/server?label=server&color=green" alt="Server Version"></a>
   <a href="https://www.npmjs.com/package/@mcp-ui/client"><img src="https://img.shields.io/npm/v/@mcp-ui/client?label=client&color=blue" alt="Client Version"></a>
+  <a href="https://rubygems.org/gems/mcp_ui_server"><img src="https://img.shields.io/gem/v/mcp_ui_server?label=ruby-server&color=red" alt="Ruby Server SDK Version"></a>
   <a href="https://gitmcp.io/idosal/mcp-ui"><img src="https://img.shields.io/endpoint?url=https://gitmcp.io/badge/idosal/mcp-ui" alt="MCP Documentation"></a>
 </p>
 
@@ -34,10 +35,11 @@
 
 ## 💡 What's `mcp-ui`?
 
-`mcp-ui` is a TypeScript SDK comprising two packages:
+`mcp-ui` is a collection of SDKs comprising:
 
-* **`@mcp-ui/server`**: Utilities to generate UI resources (`UIResource`) on your MCP server.
-* **`@mcp-ui/client`**: UI components (e.g., `<UIResourceRenderer />`) to render the UI resources and handle their events.
+* **`@mcp-ui/server` (TypeScript)**: Utilities to generate UI resources (`UIResource`) on your MCP server.
+* **`@mcp-ui/client` (TypeScript)**: UI components (e.g., `<UIResourceRenderer />`) to render the UI resources and handle their events.
+* **`mcp_ui_server` (Ruby)**: Utilities to generate UI resources on your MCP server in a Ruby environment.
 
 Together, they let you define reusable UI snippets on the server side, seamlessly and securely render them in the client, and react to their actions in the MCP host environment.
 
@@ -93,7 +95,7 @@ It accepts the following props:
 
 #### HTML (`text/html` and `text/uri-list`)
 
-Rendered using the `<HTMLResourceRenderer />` component, which displays content inside an `<iframe>`. This is suitable for self-contained HTML or embedding external apps.
+Rendered using the internal `<HTMLResourceRenderer />` component, which displays content inside an `<iframe>`. This is suitable for self-contained HTML or embedding external apps.
 
 *   **`mimeType`**:
     *   `text/html`: Renders inline HTML content.
@@ -111,6 +113,8 @@ UI snippets must be able to interact with the agent. In `mcp-ui`, this is done b
 
 ## 🏗️ Installation
 
+### TypeScript
+
 ```bash
 # using npm
 npm install @mcp-ui/server @mcp-ui/client
@@ -122,11 +126,19 @@ pnpm add @mcp-ui/server @mcp-ui/client
 yarn add @mcp-ui/server @mcp-ui/client
 ```
 
+### Ruby
+
+```bash
+gem install mcp_ui_server
+```
+
 ## 🎬 Quickstart
 
 You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to `mcp-ui`'s latest documentation! 
 
-1. **Server-side**: Build your resource blocks
+### TypeScript
+
+1. **Server-side**: Build your UI resources
 
    ```ts
    import { createUIResource } from '@mcp-ui/server';
@@ -193,7 +205,45 @@ You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to
    }
    ```
 
-3. **Enjoy** interactive MCP UI — no extra configuration required.
+### Ruby
+
+**Server-side**: Build your UI resources
+
+   ```ruby
+   require 'mcp_ui_server'
+
+   # Inline HTML
+   html_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://greeting/1',
+     content: { type: :raw_html, htmlString: '<p>Hello, from Ruby!</p>' },
+     encoding: :text
+   )
+
+   # External URL
+   external_url_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://greeting/2',
+     content: { type: :external_url, iframeUrl: 'https://example.com' },
+     encoding: :text
+   )
+
+   # remote-dom
+   remote_dom_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://remote-component/action-button',
+     content: {
+       type: :remote_dom,
+       script: "
+        const button = document.createElement('ui-button');
+        button.setAttribute('label', 'Click me from Ruby!');
+        button.addEventListener('press', () => {
+          window.parent.postMessage({ type: 'tool', payload: { toolName: 'uiInteraction', params: { action: 'button-click', from: 'ruby-remote-dom' } } }, '*');
+        });
+        root.appendChild(button);
+        ",
+       framework: :react,
+     },
+     encoding: :text
+   )
+   ```
 
 ## 🌍 Examples
 
@@ -222,7 +272,7 @@ Host and user security is one of `mcp-ui`'s primary concerns. In all content typ
 - [X] Support Web Components
 - [X] Support Remote-DOM
 - [ ] Add component libraries (in progress)
-- [ ] Add SDKs for additional programming languages (in progress)
+- [ ] Add SDKs for additional programming languages (in progress; Ruby available)
 - [ ] Support additional frontend frameworks
 - [ ] Add declarative UI content type
 - [ ] Support generative UI?
diff --git a/docs/src/.vitepress/cache/deps/_metadata.json b/docs/src/.vitepress/cache/deps/_metadata.json
index 11606a15..55662637 100644
--- a/docs/src/.vitepress/cache/deps/_metadata.json
+++ b/docs/src/.vitepress/cache/deps/_metadata.json
@@ -1,61 +1,52 @@
 {
-  "hash": "f4c42eef",
-  "configHash": "06043327",
+  "hash": "1df537aa",
+  "configHash": "1bdaab8c",
   "lockfileHash": "a6108897",
-  "browserHash": "67e7b8f5",
+  "browserHash": "3b00a27e",
   "optimized": {
     "vue": {
-      "src": "../../../../node_modules/vue/dist/vue.runtime.esm-bundler.js",
+      "src": "../../../../../node_modules/.pnpm/vue@3.5.17_typescript@5.8.3/node_modules/vue/dist/vue.runtime.esm-bundler.js",
       "file": "vue.js",
-      "fileHash": "f6ee4df0",
+      "fileHash": "a091d123",
       "needsInterop": false
     },
     "vitepress > @vue/devtools-api": {
-      "src": "../../../../node_modules/@vue/devtools-api/dist/index.js",
+      "src": "../../../../../node_modules/.pnpm/@vue+devtools-api@7.7.7/node_modules/@vue/devtools-api/dist/index.js",
       "file": "vitepress___@vue_devtools-api.js",
-      "fileHash": "17bae2c9",
+      "fileHash": "8fd91fee",
       "needsInterop": false
     },
     "vitepress > @vueuse/core": {
-      "src": "../../../../node_modules/@vueuse/core/index.mjs",
+      "src": "../../../../../node_modules/.pnpm/@vueuse+core@12.8.2_typescript@5.8.3/node_modules/@vueuse/core/index.mjs",
       "file": "vitepress___@vueuse_core.js",
-      "fileHash": "d650fb38",
-      "needsInterop": false
-    },
-    "@vue/shared": {
-      "src": "../../../../node_modules/@vue/shared/dist/shared.esm-bundler.js",
-      "file": "@vue_shared.js",
-      "fileHash": "f90b9ade",
+      "fileHash": "ad70e6a2",
       "needsInterop": false
     },
     "vitepress > @vueuse/integrations/useFocusTrap": {
-      "src": "../../../../node_modules/@vueuse/integrations/useFocusTrap.mjs",
+      "src": "../../../../../node_modules/.pnpm/@vueuse+integrations@12.8.2_focus-trap@7.6.5_typescript@5.8.3/node_modules/@vueuse/integrations/useFocusTrap.mjs",
       "file": "vitepress___@vueuse_integrations_useFocusTrap.js",
-      "fileHash": "51780127",
+      "fileHash": "18c218a8",
       "needsInterop": false
     },
     "vitepress > mark.js/src/vanilla.js": {
-      "src": "../../../../node_modules/mark.js/src/vanilla.js",
+      "src": "../../../../../node_modules/.pnpm/mark.js@8.11.1/node_modules/mark.js/src/vanilla.js",
       "file": "vitepress___mark__js_src_vanilla__js.js",
-      "fileHash": "312e849a",
+      "fileHash": "65deea21",
       "needsInterop": false
     },
     "vitepress > minisearch": {
-      "src": "../../../../node_modules/minisearch/dist/es/index.js",
+      "src": "../../../../../node_modules/.pnpm/minisearch@7.1.2/node_modules/minisearch/dist/es/index.js",
       "file": "vitepress___minisearch.js",
-      "fileHash": "6e8437ee",
+      "fileHash": "d461f573",
       "needsInterop": false
     }
   },
   "chunks": {
-    "chunk-IDCUKJPY": {
-      "file": "chunk-IDCUKJPY.js"
-    },
-    "chunk-T4BGSLFB": {
-      "file": "chunk-T4BGSLFB.js"
+    "chunk-KXRKCYS5": {
+      "file": "chunk-KXRKCYS5.js"
     },
-    "chunk-R5RQUVAY": {
-      "file": "chunk-R5RQUVAY.js"
+    "chunk-ESX2ELK6": {
+      "file": "chunk-ESX2ELK6.js"
     }
   }
 }
\ No newline at end of file
diff --git a/docs/src/.vitepress/config.ts b/docs/src/.vitepress/config.ts
index 47b7ca90..4c164a00 100644
--- a/docs/src/.vitepress/config.ts
+++ b/docs/src/.vitepress/config.ts
@@ -80,6 +80,10 @@ export default defineConfig({
             text: '@mcp-ui/server',
             link: 'https://www.npmjs.com/package/@mcp-ui/server',
           },
+          {
+            text: 'Ruby Gem',
+            link: 'https://rubygems.org/gems/mcp_ui_server',
+          },
         ],
       },
     ],
@@ -95,11 +99,25 @@ export default defineConfig({
           ],
         },
         {
-          text: 'Server SDK',
+          text: 'Server SDKs',
           collapsed: false,
           items: [
-            { text: 'Overview', link: '/guide/server/overview' },
-            { text: 'Usage & Examples', link: '/guide/server/usage-examples' },
+            {
+              text: 'TypeScript',
+              collapsed: false,
+              items: [
+                { text: 'Overview', link: '/guide/server/typescript/overview' },
+                { text: 'Usage & Examples', link: '/guide/server/typescript/usage-examples' },
+              ],
+            },
+            {
+              text: 'Ruby',
+              collapsed: false,
+              items: [
+                { text: 'Overview', link: '/guide/server/ruby/overview' },
+                { text: 'Usage & Examples', link: '/guide/server/ruby/usage-examples' },
+              ],
+            },
           ],
         },
         {
@@ -173,6 +191,7 @@ export default defineConfig({
     socialLinks: [
       { icon: 'github', link: 'https://github.com/idosal/mcp-ui' },
       { icon: 'npm', link: 'https://www.npmjs.com/package/@mcp-ui/server' },
+      { icon: 'github', link: 'https://rubygems.org/gems/mcp_ui_server' },
     ],
 
     footer: {
diff --git a/docs/src/guide/client/using-a-proxy.md b/docs/src/guide/client/using-a-proxy.md
index 4a5cbebd..9b7332cb 100644
--- a/docs/src/guide/client/using-a-proxy.md
+++ b/docs/src/guide/client/using-a-proxy.md
@@ -46,6 +46,6 @@ A valid proxy script must:
 
 ### Example Self-Hosted Proxy
 
-Here is an example of a self-hosted proxy script that meets these requirements. You can find this file in `packages/client/scripts/proxy/index.html`.
+Here is an example of a self-hosted proxy script that meets these requirements. You can find this file in `sdks/typescript/client/scripts/proxy/index.html`.
 
-<<< @/../../packages/client/scripts/proxy/index.html 
+<<< @/../../sdks/typescript/client/scripts/proxy/index.html 
diff --git a/docs/src/guide/introduction.md b/docs/src/guide/introduction.md
index ec911bb6..9892dbb0 100644
--- a/docs/src/guide/introduction.md
+++ b/docs/src/guide/introduction.md
@@ -9,12 +9,13 @@ You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to
 
 ## What is MCP-UI?
 
-MCP-UI is a TypeScript SDK containing:
+MCP-UI provides SDKs for multiple languages, including:
 
-- **`@mcp-ui/client`**: UI components (like `<UIResourceRenderer />`) for easy rendering of interactive UI.
-- **`@mcp-ui/server`**: Helper functions (like `createUIResource`) for server-side logic to easily construct `UIResource` objects.
+- **`@mcp-ui/client`**: A Typescript package with UI components (like `<UIResourceRenderer />`) for easy rendering of interactive UI.
+- **`@mcp-ui/server`**: A Typescript package with helper functions (like `createUIResource`) for server-side logic to easily construct `UIResource` objects.
+- **`mcp_ui_server`**: A Ruby gem with helper methods (like `create_ui_resource`) for server-side logic in Ruby applications.
 
-## Core Concept: The Interactive UI Resource Protocol
+## The Interactive UI Resource Protocol
 
 The central piece of this SDK is the `UIResource`. This object defines a contract for how interactive UI should be structured and delivered from a server/tool to a client.
 
@@ -44,13 +45,15 @@ interface UIResource {
 
 ## How It Works
 
-1. **Server Side**: Use `@mcp-ui/server` to create `HTMLResourceRenderer` objects
-2. **Client Side**: Use `@mcp-ui/client` to render these resources in your React app
+1. **Server Side**: Use the server SDK for your language to create `UIResource` objects.
+2. **Client Side**: Use `@mcp-ui/client` to render these resources in your React app.
 
 ### Example Flow
 
 **Server (MCP Tool):**
-```typescript
+::: code-group
+
+```typescript [TypeScript]
 import { createUIResource } from '@mcp-ui/server';
 
 const resource = createUIResource({
@@ -63,6 +66,21 @@ const resource = createUIResource({
 return { content: [resource] };
 ```
 
+```ruby [Ruby]
+require 'mcp_ui_server'
+
+resource = McpUiServer.create_ui_resource(
+  uri: 'ui://my-tool/dashboard',
+  content: { type: :raw_html, htmlString: '<h1>Dashboard</h1>' },
+  encoding: :text
+)
+
+# Return in MCP response
+{ content: [resource] }
+```
+
+:::
+
 **Client (React App):**
 ```tsx
 import { UIResourceRenderer } from '@mcp-ui/client';
@@ -93,14 +111,15 @@ function App({ mcpResponse }) {
 - **Flexible**: Supports both direct HTML content and external applications
 - **Future-proof**: Extensible design supports new resource types as they're added
 
+## Philosophy
+
+Allowing MCP servers to respond with UI snippets is a powerful way to create interactive experiences in hosts. Nailing down the best way to do it is challenging, and is an ongoing discussion in the MCP community and the [UI Community Working Group](https://github.com/modelcontextprotocol-community/working-groups/issues/35).
+This project is an experimental playground for MCP-UI ideas, that aims to test out philosophies in the wild.
+
 ## Next Steps
 
 - [Getting Started](./getting-started.md) - Set up your development environment
-- [Server SDK](./server/overview.md) - Learn to create resources
-- [Client SDK](./client/overview.md) - Learn to render resources
+- [Client SDK](./client/overview.md) - Learn to render UI resources
+- [Typescript Server SDK](./server/typescript/overview.md) - Learn to create UI resources in Typescript
+- [Ruby Server SDK](./server/ruby/overview.md) - Learn to create UI resources in Ruby
 - [Protocol Details](./protocol-details.md) - Understand the underlying protocol
-
-## Philosophy
-
-Allowing MCP servers to respond with UI snippets is a powerful way to create interactive experiences in hosts. Nailing down the best way to do it is challenging, and is an ongoing discussion in the MCP community and the [UI Community Working Group](https://github.com/modelcontextprotocol-community/working-groups/issues/35).
-This project is an experimental playground for MCP-UI ideas, that aims to test out philosophies in the wild.
\ No newline at end of file
diff --git a/docs/src/guide/server/ruby/overview.md b/docs/src/guide/server/ruby/overview.md
new file mode 100644
index 00000000..8625218c
--- /dev/null
+++ b/docs/src/guide/server/ruby/overview.md
@@ -0,0 +1,36 @@
+# mcp_ui_server Overview
+
+The `mcp_ui_server` gem provides server-side utilities in Ruby to help construct `UIResource` objects, which can then be sent to a client as part of an MCP response.
+
+## Key Methods
+
+- **`McpUiServer.create_ui_resource(options)`**:
+  The primary method for creating UI snippets. It takes an options hash to define the URI, content (direct HTML or external URL), and encoding method.
+
+## Purpose
+
+- **Ease of Use**: Simplifies the creation of valid `UIResource` objects in Ruby.
+- **Validation**: Includes basic validation (e.g., URI prefixes matching content type).
+- **Encoding**: Handles Base64 encoding automatically.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mcp_ui_server'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install mcp_ui_server
+```
+
+See the [Server SDK Usage & Examples](./usage-examples.md) page for practical examples.
diff --git a/docs/src/guide/server/ruby/usage-examples.md b/docs/src/guide/server/ruby/usage-examples.md
new file mode 100644
index 00000000..32a1e3c1
--- /dev/null
+++ b/docs/src/guide/server/ruby/usage-examples.md
@@ -0,0 +1,131 @@
+# mcp_ui_server Usage & Examples
+
+This page provides practical examples for using the `mcp_ui_server` gem.
+
+## Basic Setup
+
+First, ensure you have `mcp_ui_server` available in your project by adding it to your Gemfile and running `bundle install`.
+
+```ruby
+require 'mcp_ui_server'
+require 'json'
+
+# Example 1: Direct HTML, delivered as text
+resource1 = McpUiServer.create_ui_resource(
+  uri: 'ui://my-component/instance-1',
+  content: { type: :raw_html, htmlString: '<p>Hello World</p>' },
+  encoding: :text
+)
+puts "Resource 1: #{JSON.pretty_generate(resource1)}"
+# Output for Resource 1:
+# {
+#   "type": "resource",
+#   "resource": {
+#     "uri": "ui://my-component/instance-1",
+#     "mimeType": "text/html",
+#     "text": "<p>Hello World</p>"
+#   }
+# }
+
+# Example 2: Direct HTML, delivered as a Base64 blob
+resource2 = McpUiServer.create_ui_resource(
+  uri: 'ui://my-component/instance-2',
+  content: { type: :raw_html, htmlString: '<h1>Complex HTML</h1>' },
+  encoding: :blob
+)
+puts "Resource 2 (blob will be Base64): #{JSON.pretty_generate(resource2)}"
+# Output for Resource 2:
+# {
+#   "type": "resource",
+#   "resource": {
+#     "uri": "ui://my-component/instance-2",
+#     "mimeType": "text/html",
+#     "blob": "PGgxPkNvbXBsZXggSFRNTDwvaDE+"
+#   }
+# }
+
+# Example 3: External URL, text encoding
+dashboard_url = 'https://my.analytics.com/dashboard/123'
+resource3 = McpUiServer.create_ui_resource(
+  uri: 'ui://analytics-dashboard/main',
+  content: { type: :external_url, iframeUrl: dashboard_url },
+  encoding: :text
+)
+puts "Resource 3: #{JSON.pretty_generate(resource3)}"
+# Output for Resource 3:
+# {
+#   "type": "resource",
+#   "resource": {
+#     "uri": "ui://analytics-dashboard/main",
+#     "mimeType": "text/uri-list",
+#     "text": "https://my.analytics.com/dashboard/123"
+#   }
+# }
+
+# Example 4: External URL, blob encoding (URL is Base64 encoded)
+chart_api_url = 'https://charts.example.com/api?type=pie&data=1,2,3'
+resource4 = McpUiServer.create_ui_resource(
+  uri: 'ui://live-chart/session-xyz',
+  content: { type: :external_url, iframeUrl: chart_api_url },
+  encoding: :blob
+)
+puts "Resource 4 (blob will be Base64 of URL): #{JSON.pretty_generate(resource4)}"
+# Output for Resource 4:
+# {
+#   "type": "resource",
+#   "resource": {
+#     "uri": "ui://live-chart/session-xyz",
+#     "mimeType": "text/uri-list",
+#     "blob": "aHR0cHM6Ly9jaGFydHMuZXhhbXBsZS5jb20vYXBpP3R5cGU9cGllJmRhdGE9MSwyLDM="
+#   }
+# }
+
+# Example 5: Remote DOM script, text encoding
+remote_dom_script = <<-SCRIPT
+  const button = document.createElement('ui-button');
+  button.setAttribute('label', 'Click me for a tool call!');
+  button.addEventListener('press', () => {
+    window.parent.postMessage({ type: 'tool', payload: { toolName: 'uiInteraction', params: { action: 'button-click', from: 'remote-dom' } } }, '*');
+  });
+  root.appendChild(button);
+SCRIPT
+
+resource5 = McpUiServer.create_ui_resource(
+  uri: 'ui://remote-component/action-button',
+  content: {
+    type: :remote_dom,
+    script: remote_dom_script,
+    framework: :react # or :webcomponents
+  },
+  encoding: :text
+)
+puts "Resource 5: #{JSON.pretty_generate(resource5)}"
+# Output for Resource 5:
+# {
+#   "type": "resource",
+#   "resource": {
+#     "uri": "ui://remote-component/action-button",
+#     "mimeType": "application/vnd.mcp-ui.remote-dom+javascript; framework=react",
+#     "text": "  const button = document.createElement('ui-button');\n  button.setAttribute('label', 'Click me for a tool call!');\n  button.addEventListener('press', () => {\n    window.parent.postMessage({ type: 'tool', payload: { toolName: 'uiInteraction', params: { action: 'button-click', from: 'remote-dom' } } }, '*');\n  });\n  root.appendChild(button);\n"
+#   }
+# }
+
+# These resource objects would then be included in the 'content' array
+# of a toolResult in an MCP interaction.
+
+## Error Handling
+
+The `create_ui_resource` method will raise an `ArgumentError` if invalid combinations are provided.
+
+```ruby
+begin
+  McpUiServer.create_ui_resource(
+    uri: 'invalid://should-be-ui',
+    content: { type: :external_url, iframeUrl: 'https://example.com' },
+    encoding: :text
+  )
+rescue ArgumentError => e
+  puts "Caught expected error: #{e.message}"
+  # => Caught expected error: URI must start with 'ui://' for externalUrl content type.
+end
+```
\ No newline at end of file
diff --git a/docs/src/guide/server/overview.md b/docs/src/guide/server/typescript/overview.md
similarity index 100%
rename from docs/src/guide/server/overview.md
rename to docs/src/guide/server/typescript/overview.md
diff --git a/docs/src/guide/server/usage-examples.md b/docs/src/guide/server/typescript/usage-examples.md
similarity index 100%
rename from docs/src/guide/server/usage-examples.md
rename to docs/src/guide/server/typescript/usage-examples.md
diff --git a/docs/src/index.md b/docs/src/index.md
index fd23a651..9d506452 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -4,7 +4,7 @@ layout: home
 hero:
   name: MCP-UI
   text: Interactive UI Components for MCP
-  tagline: Build rich, dynamic user interfaces for your MCP applications with TypeScript SDKs that bring UI to AI interactions.
+  tagline: Build rich, dynamic user interfaces for your MCP applications with SDKs that bring UI to AI interactions.
   image:
     light: /logo-lg-black.png
     dark: /logo-lg.png
@@ -23,8 +23,8 @@ hero:
 features:
   - title: ⚛️ Client SDK
     details: React components and hooks for seamless frontend integration. Render interactive UI resources with the UIResourceRenderer component and handle UI actions effortlessly.
-  - title: 🛠️ Server SDK
-    details: Powerful utilities to construct interactive UI for MCP servers. Create HTML, React, Web Components, and external app UI with ergonomic API.
+  - title: 🛠️ Server SDKs
+    details: Powerful utilities to construct interactive UI for MCP servers. Create HTML, React, Web Components, and external app UI with ergonomic APIs for Typescript and Ruby.
   - title: 🔒 Secure
     details: All remote code executes in sandboxed iframes, ensuring host and user security while maintaining rich interactivity.
   - title: 🎨 Flexible
@@ -47,20 +47,35 @@ features:
 
 **Server Side** - Create interactive resources to return in your MCP tool results:
 
-```typescript
+::: code-group
+```typescript [TypeScript]
 import { createUIResource } from '@mcp-ui/server';
 
 const interactiveForm = createUIResource({
   uri: 'ui://user-form/1',
-  content: { 
-    type: 'externalUrl', 
+  content: {
+    type: 'externalUrl',
     iframeUrl: 'https://yourapp.com'
   },
   encoding: 'text',
 });
 ```
 
-**Client Side** - Render with one component:
+```ruby [Ruby]
+require 'mcp_ui_server'
+
+interactive_form = McpUiServer.create_ui_resource(
+  uri: 'ui://user-form/1',
+  content: {
+    type: :external_url,
+    iframeUrl: 'https://yourapp.com'
+  },
+  encoding: :text
+)
+```
+:::
+
+**Client Side** - Render on the host with a single component:
 
 ```tsx
 import { UIResourceRenderer } from '@mcp-ui/client';
@@ -71,7 +86,6 @@ function MyApp({ mcpResource }) {
       resource={mcpResource.resource}
       onUIAction={(action) => {
         console.log('User action:', action);
-        return { status: 'ok' };
       }}
     />
   );
diff --git a/package.json b/package.json
index 52605a72..ab25a4f0 100644
--- a/package.json
+++ b/package.json
@@ -3,10 +3,12 @@
   "private": true,
   "scripts": {
     "preinstall": "npx only-allow pnpm",
-    "dev": "pnpm --filter=\"./packages/*\" --parallel dev",
-    "build": "pnpm --filter=\"./packages/*\" build",
-    "preview": "pnpm --filter=\"./packages/*\" --parallel preview",
-    "test": "vitest",
+    "dev": "pnpm --filter=\"./sdks/typescript/*\" --parallel dev",
+    "build": "pnpm --filter=\"./sdks/typescript/*\" build",
+    "preview": "pnpm --filter=\"./sdks/typescript/*\" --parallel preview",
+    "test": "pnpm test:ts && pnpm test:ruby",
+    "test:ts": "vitest run",
+    "test:ruby": "cd sdks/ruby && bundle install && bundle exec rake spec",
     "test:watch": "vitest watch",
     "coverage": "vitest run --coverage",
     "lint": "eslint . --ext .ts,.tsx,.js,.jsx",
@@ -20,9 +22,12 @@
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.3",
     "@semantic-release/npm": "^12.0.0",
+    "@semantic-release/release-notes-generator": "^14.0.3",
     "@swc/core": "^1.4.0",
     "@testing-library/jest-dom": "^6.1.5",
     "@testing-library/react": "^14.1.2",
diff --git a/packages/client/src/utils/__tests__/processResource.test.ts b/packages/client/src/utils/__tests__/processResource.test.ts
deleted file mode 100644
index ff096c9f..00000000
--- a/packages/client/src/utils/__tests__/processResource.test.ts
+++ /dev/null
@@ -1,129 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { processHTMLResource } from '../processResource';
-
-describe('text/uri-list', () => {
-  it('should process a valid https URL', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'https://example.com',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('https://example.com');
-    expect(result.iframeRenderMode).toBe('src');
-  });
-
-  it('should process a valid http URL', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'http://example.com',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('http://example.com');
-    expect(result.iframeRenderMode).toBe('src');
-  });
-
-  it('should return an error for an invalid URL (javascript:alert)', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'javascript:alert("pwned")',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBe('No valid URLs found in uri-list content.');
-    expect(result.iframeSrc).toBeUndefined();
-  });
-
-  it('should return an error for a blob URL', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'blob:https://example.com/some-uuid',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBe('No valid URLs found in uri-list content.');
-    expect(result.iframeSrc).toBeUndefined();
-  });
-
-  it('should extract the first valid URL from a list', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: '# comment\ninvalid-url\nhttps://first-valid.com\nhttps://second-valid.com',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('https://first-valid.com');
-  });
-
-  it('should handle empty or commented-out content', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: '# just a comment\n# another comment',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBe('No valid URLs found in uri-list content.');
-  });
-
-  it('should return error for content with no valid URLs', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'just-some-string\nanother-string',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBe('No valid URLs found in uri-list content.');
-  });
-
-  it('should use proxy when provided for external URLs', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'https://example.com',
-    };
-    const result = processHTMLResource(resource, 'https://proxy.mcpui.dev/');
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('https://proxy.mcpui.dev/?url=https%3A%2F%2Fexample.com');
-    expect(result.iframeRenderMode).toBe('src');
-  });
-
-  it('should handle proxy with existing query parameters', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'https://example.com',
-    };
-    const result = processHTMLResource(resource, 'https://proxy.mcpui.dev/?a=1&b=2');
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('https://proxy.mcpui.dev/?a=1&b=2&url=https%3A%2F%2Fexample.com');
-    expect(result.iframeRenderMode).toBe('src');
-  });
-
-  it('should fallback to direct URL if proxy is invalid', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'https://example.com',
-    };
-    const result = processHTMLResource(resource, 'not-a-valid-url');
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('https://example.com');
-    expect(result.iframeRenderMode).toBe('src');
-  });
-
-  it('should not use proxy when proxy is empty string', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'https://example.com',
-    };
-    const result = processHTMLResource(resource, '');
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('https://example.com');
-    expect(result.iframeRenderMode).toBe('src');
-  });
-
-  it('should not use proxy when proxy is not provided', () => {
-    const resource = {
-      mimeType: 'text/uri-list',
-      text: 'https://example.com',
-    };
-    const result = processHTMLResource(resource);
-    expect(result.error).toBeUndefined();
-    expect(result.iframeSrc).toBe('https://example.com');
-    expect(result.iframeRenderMode).toBe('src');
-  });
-});
diff --git a/packages/shared/tsconfig.json b/packages/shared/tsconfig.json
deleted file mode 100644
index 7d2acc99..00000000
--- a/packages/shared/tsconfig.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "include": ["src"],
-  "exclude": ["node_modules", "dist", "src/__tests__"]
-}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 7c68ad94..a03d38ff 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -11,15 +11,24 @@ importers:
       '@semantic-release/changelog':
         specifier: ^6.0.3
         version: 6.0.3(semantic-release@23.1.1(typescript@5.8.3))
+      '@semantic-release/commit-analyzer':
+        specifier: ^13.0.1
+        version: 13.0.1(semantic-release@23.1.1(typescript@5.8.3))
       '@semantic-release/exec':
         specifier: ^6.0.3
         version: 6.0.3(semantic-release@23.1.1(typescript@5.8.3))
       '@semantic-release/git':
         specifier: ^10.0.1
         version: 10.0.1(semantic-release@23.1.1(typescript@5.8.3))
+      '@semantic-release/github':
+        specifier: ^11.0.3
+        version: 11.0.3(semantic-release@23.1.1(typescript@5.8.3))
       '@semantic-release/npm':
         specifier: ^12.0.0
         version: 12.0.1(semantic-release@23.1.1(typescript@5.8.3))
+      '@semantic-release/release-notes-generator':
+        specifier: ^14.0.3
+        version: 14.0.3(semantic-release@23.1.1(typescript@5.8.3))
       '@swc/core':
         specifier: ^1.4.0
         version: 1.12.6
@@ -109,7 +118,7 @@ importers:
     dependencies:
       '@mcp-ui/client':
         specifier: workspace:*
-        version: link:../../packages/client
+        version: link:../../sdks/typescript/client
       react:
         specifier: ^18.3.1
         version: 18.3.1
@@ -152,7 +161,7 @@ importers:
     dependencies:
       '@mcp-ui/client':
         specifier: workspace:*
-        version: link:../../packages/client
+        version: link:../../sdks/typescript/client
       '@quilted/threads':
         specifier: ^3.1.3
         version: 3.1.3(@preact/signals-core@1.10.0)
@@ -309,7 +318,7 @@ importers:
         specifier: ^4.15.1
         version: 4.21.2(@cloudflare/workers-types@4.20250620.0)
 
-  packages/client:
+  sdks/typescript/client:
     dependencies:
       '@modelcontextprotocol/sdk':
         specifier: '*'
@@ -361,7 +370,7 @@ importers:
         specifier: ^1.0.0
         version: 1.6.1(@types/node@22.15.33)(jsdom@22.1.0)(lightningcss@1.30.1)
 
-  packages/server:
+  sdks/typescript/server:
     dependencies:
       '@modelcontextprotocol/sdk':
         specifier: '*'
@@ -386,7 +395,7 @@ importers:
         specifier: ^1.0.0
         version: 1.6.1(@types/node@18.19.112)(jsdom@23.2.0)(lightningcss@1.30.1)
 
-  packages/shared:
+  sdks/typescript/shared:
     devDependencies:
       typescript:
         specifier: ^5.0.0
@@ -1683,18 +1692,34 @@ packages:
     resolution: {integrity: sha512-JcQDsBdg49Yky2w2ld20IHAlwr8d/d8N6NiOXbtuoPCqzbsiJgF633mVUw3x4mo0H5ypataQIX7SFu3yy44Mpw==}
     engines: {node: '>= 18'}
 
+  '@octokit/auth-token@6.0.0':
+    resolution: {integrity: sha512-P4YJBPdPSpWTQ1NU4XYdvHvXJJDxM6YwpS0FZHRgP7YFkdVxsWcpWGy/NVqlAA7PcPCnMacXlRm1y2PFZRWL/w==}
+    engines: {node: '>= 20'}
+
   '@octokit/core@6.1.5':
     resolution: {integrity: sha512-vvmsN0r7rguA+FySiCsbaTTobSftpIDIpPW81trAmsv9TGxg3YCujAxRYp/Uy8xmDgYCzzgulG62H7KYUFmeIg==}
     engines: {node: '>= 18'}
 
+  '@octokit/core@7.0.2':
+    resolution: {integrity: sha512-ODsoD39Lq6vR6aBgvjTnA3nZGliknKboc9Gtxr7E4WDNqY24MxANKcuDQSF0jzapvGb3KWOEDrKfve4HoWGK+g==}
+    engines: {node: '>= 20'}
+
   '@octokit/endpoint@10.1.4':
     resolution: {integrity: sha512-OlYOlZIsfEVZm5HCSR8aSg02T2lbUWOsCQoPKfTXJwDzcHQBrVBGdGXb89dv2Kw2ToZaRtudp8O3ZIYoaOjKlA==}
     engines: {node: '>= 18'}
 
+  '@octokit/endpoint@11.0.0':
+    resolution: {integrity: sha512-hoYicJZaqISMAI3JfaDr1qMNi48OctWuOih1m80bkYow/ayPw6Jj52tqWJ6GEoFTk1gBqfanSoI1iY99Z5+ekQ==}
+    engines: {node: '>= 20'}
+
   '@octokit/graphql@8.2.2':
     resolution: {integrity: sha512-Yi8hcoqsrXGdt0yObxbebHXFOiUA+2v3n53epuOg1QUgOB6c4XzvisBNVXJSl8RYA5KrDuSL2yq9Qmqe5N0ryA==}
     engines: {node: '>= 18'}
 
+  '@octokit/graphql@9.0.1':
+    resolution: {integrity: sha512-j1nQNU1ZxNFx2ZtKmL4sMrs4egy5h65OMDmSbVyuCzjOcwsHq6EaYjOTGXPQxgfiN8dJ4CriYHk6zF050WEULg==}
+    engines: {node: '>= 20'}
+
   '@octokit/openapi-types@24.2.0':
     resolution: {integrity: sha512-9sIH3nSUttelJSXUrmGzl7QUBFul0/mB8HRYl3fOlgHbIWG+WnYDXU3v/2zMtAvuzZ/ed00Ei6on975FhBfzrg==}
 
@@ -1707,12 +1732,30 @@ packages:
     peerDependencies:
       '@octokit/core': '>=6'
 
+  '@octokit/plugin-paginate-rest@13.1.1':
+    resolution: {integrity: sha512-q9iQGlZlxAVNRN2jDNskJW/Cafy7/XE52wjZ5TTvyhyOD904Cvx//DNyoO3J/MXJ0ve3rPoNWKEg5iZrisQSuw==}
+    engines: {node: '>= 20'}
+    peerDependencies:
+      '@octokit/core': '>=6'
+
   '@octokit/plugin-retry@7.2.1':
     resolution: {integrity: sha512-wUc3gv0D6vNHpGxSaR3FlqJpTXGWgqmk607N9L3LvPL4QjaxDgX/1nY2mGpT37Khn+nlIXdljczkRnNdTTV3/A==}
     engines: {node: '>= 18'}
     peerDependencies:
       '@octokit/core': '>=6'
 
+  '@octokit/plugin-retry@8.0.1':
+    resolution: {integrity: sha512-KUoYR77BjF5O3zcwDQHRRZsUvJwepobeqiSSdCJ8lWt27FZExzb0GgVxrhhfuyF6z2B2zpO0hN5pteni1sqWiw==}
+    engines: {node: '>= 20'}
+    peerDependencies:
+      '@octokit/core': '>=7'
+
+  '@octokit/plugin-throttling@11.0.1':
+    resolution: {integrity: sha512-S+EVhy52D/272L7up58dr3FNSMXWuNZolkL4zMJBNIfIxyZuUcczsQAU4b5w6dewJXnKYVgSHSV5wxitMSW1kw==}
+    engines: {node: '>= 20'}
+    peerDependencies:
+      '@octokit/core': ^7.0.0
+
   '@octokit/plugin-throttling@9.6.1':
     resolution: {integrity: sha512-bt3EBUkeKUzDQXRCcFrR9SWVqlLFRRqcCrr6uAorWt6NXTyjMKqcGrFmXqJy9NCbnKgiIZ2OXWq04theFc76Jg==}
     engines: {node: '>= 18'}
@@ -1723,6 +1766,14 @@ packages:
     resolution: {integrity: sha512-WEi/R0Jmq+IJKydWlKDmryPcmdYSVjL3ekaiEL1L9eo1sUnqMJ+grqmC9cjk7CA7+b2/T397tO5d8YLOH3qYpQ==}
     engines: {node: '>= 18'}
 
+  '@octokit/request-error@7.0.0':
+    resolution: {integrity: sha512-KRA7VTGdVyJlh0cP5Tf94hTiYVVqmt2f3I6mnimmaVz4UG3gQV/k4mDJlJv3X67iX6rmN7gSHCF8ssqeMnmhZg==}
+    engines: {node: '>= 20'}
+
+  '@octokit/request@10.0.3':
+    resolution: {integrity: sha512-V6jhKokg35vk098iBqp2FBKunk3kMTXlmq+PtbV9Gl3TfskWlebSofU9uunVKhUN7xl+0+i5vt0TGTG8/p/7HA==}
+    engines: {node: '>= 20'}
+
   '@octokit/request@9.2.4':
     resolution: {integrity: sha512-q8ybdytBmxa6KogWlNa818r0k1wlqzNC+yNkcQDECHvQo8Vmstrg18JwqJHdJdUiHD2sjlwBgSm9kHkOKe2iyA==}
     engines: {node: '>= 18'}
@@ -2227,6 +2278,12 @@ packages:
     peerDependencies:
       semantic-release: '>=20.1.0'
 
+  '@semantic-release/commit-analyzer@13.0.1':
+    resolution: {integrity: sha512-wdnBPHKkr9HhNhXOhZD5a2LNl91+hs8CC2vsAVYxtZH3y0dV3wKn+uZSN61rdJQZ8EGxzWB3inWocBHV9+u/CQ==}
+    engines: {node: '>=20.8.1'}
+    peerDependencies:
+      semantic-release: '>=20.1.0'
+
   '@semantic-release/error@3.0.0':
     resolution: {integrity: sha512-5hiM4Un+tpl4cKw3lV4UgzJj+SmfNIDCLLw0TepzQxz9ZGV5ixnqkzIVF+3tp0ZHgcMKE+VNGHJjEeyFG2dcSw==}
     engines: {node: '>=14.17'}
@@ -2253,6 +2310,12 @@ packages:
     peerDependencies:
       semantic-release: '>=20.1.0'
 
+  '@semantic-release/github@11.0.3':
+    resolution: {integrity: sha512-T2fKUyFkHHkUNa5XNmcsEcDPuG23hwBKptfUVcFXDVG2cSjXXZYDOfVYwfouqbWo/8UefotLaoGfQeK+k3ep6A==}
+    engines: {node: '>=20.8.1'}
+    peerDependencies:
+      semantic-release: '>=24.1.0'
+
   '@semantic-release/npm@12.0.1':
     resolution: {integrity: sha512-/6nntGSUGK2aTOI0rHPwY3ZjgY9FkXmEHbW9Kr+62NVOsyqpKKeP0lrCH+tphv+EsNdJNmqqwijTEnVWUMQ2Nw==}
     engines: {node: '>=20.8.1'}
@@ -2265,6 +2328,12 @@ packages:
     peerDependencies:
       semantic-release: '>=20.1.0'
 
+  '@semantic-release/release-notes-generator@14.0.3':
+    resolution: {integrity: sha512-XxAZRPWGwO5JwJtS83bRdoIhCiYIx8Vhr+u231pQAsdFIAbm19rSVJLdnBN+Avvk7CKvNQE/nJ4y7uqKH6WTiw==}
+    engines: {node: '>=20.8.1'}
+    peerDependencies:
+      semantic-release: '>=20.1.0'
+
   '@shikijs/core@2.5.0':
     resolution: {integrity: sha512-uu/8RExTKtavlpH7XqnVYBrfBkUc20ngXiX9NSrBhOVZYv/7XQRKUyhtkeflY5QsxC0GbJThCerruZfsUaSldg==}
 
@@ -3342,6 +3411,9 @@ packages:
   before-after-hook@3.0.2:
     resolution: {integrity: sha512-Nik3Sc0ncrMK4UUdXQmAnRtzmNQTAAXmXIopizwZ1W1t8QmfJj+zL4OA2I7XPTPW5z5TDqv4hRo/JzouDJnX3A==}
 
+  before-after-hook@4.0.0:
+    resolution: {integrity: sha512-q6tR3RPqIB1pMiTRMFcZwuG5T8vwp+vUvEG0vuI6B+Rikh5BfPp2fQ82c925FOs+b0lcFQ8CFrL+KbilfZFhOQ==}
+
   bidi-js@1.0.3:
     resolution: {integrity: sha512-RKshQI1R3YQ+n9YJz2QQ147P66ELpa1FQEg20Dk8oW9t2KgLbpDLLp9aGZ7y8WHSshDknG0bknqGw5/tyCs5tw==}
 
@@ -3571,20 +3643,38 @@ packages:
     resolution: {integrity: sha512-ROjNchA9LgfNMTTFSIWPzebCwOGFdgkEq45EnvvrmSLvCtAw0HSmrCs7/ty+wAeYUZyNay0YMUNYFTRL72PkBQ==}
     engines: {node: '>=16'}
 
+  conventional-changelog-angular@8.0.0:
+    resolution: {integrity: sha512-CLf+zr6St0wIxos4bmaKHRXWAcsCXrJU6F4VdNDrGRK3B8LDLKoX3zuMV5GhtbGkVR/LohZ6MT6im43vZLSjmA==}
+    engines: {node: '>=18'}
+
   conventional-changelog-writer@7.0.1:
     resolution: {integrity: sha512-Uo+R9neH3r/foIvQ0MKcsXkX642hdm9odUp7TqgFS7BsalTcjzRlIfWZrZR1gbxOozKucaKt5KAbjW8J8xRSmA==}
     engines: {node: '>=16'}
     hasBin: true
 
+  conventional-changelog-writer@8.1.0:
+    resolution: {integrity: sha512-dpC440QnORNCO81XYuRRFOLCsjKj4W7tMkUIn3lR6F/FAaJcWLi7iCj6IcEvSQY2zw6VUgwUKd5DEHKEWrpmEQ==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   conventional-commits-filter@4.0.0:
     resolution: {integrity: sha512-rnpnibcSOdFcdclpFwWa+pPlZJhXE7l+XK04zxhbWrhgpR96h33QLz8hITTXbcYICxVr3HZFtbtUAQ+4LdBo9A==}
     engines: {node: '>=16'}
 
+  conventional-commits-filter@5.0.0:
+    resolution: {integrity: sha512-tQMagCOC59EVgNZcC5zl7XqO30Wki9i9J3acbUvkaosCT6JX3EeFwJD7Qqp4MCikRnzS18WXV3BLIQ66ytu6+Q==}
+    engines: {node: '>=18'}
+
   conventional-commits-parser@5.0.0:
     resolution: {integrity: sha512-ZPMl0ZJbw74iS9LuX9YIAiW8pfM5p3yh2o/NbXHbkFuZzY5jvdi5jFycEOkmBW5H5I7nA+D6f3UcsCLP2vvSEA==}
     engines: {node: '>=16'}
     hasBin: true
 
+  conventional-commits-parser@6.2.0:
+    resolution: {integrity: sha512-uLnoLeIW4XaoFtH37qEcg/SXMJmKF4vi7V0H2rnPueg+VEtFGA/asSCNTcq4M/GQ6QmlzchAEtOoDTtKqWeHag==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   convert-hrtime@5.0.0:
     resolution: {integrity: sha512-lOETlkIeYSJWcbbcvjRKGxVMXJR+8+OQb/mTPbA4ObPMytYIsUbuOE0Jzy60hjARYszq1id0j8KgVhC+WGZVTg==}
     engines: {node: '>=12'}
@@ -4201,6 +4291,9 @@ packages:
   fast-content-type-parse@2.0.1:
     resolution: {integrity: sha512-nGqtvLrj5w0naR6tDPfB4cUmYCqouzyQiz6C5y/LtcDllJdrcc6WaWW6iXyIIOErTa/XRybj28aasdn4LkVk6Q==}
 
+  fast-content-type-parse@3.0.0:
+    resolution: {integrity: sha512-ZvLdcY8P+N8mGQJahJV5G4U88CSvT1rP8ApL6uETe88MBXrBHAkZlSEySdUlyztF7ccb+Znos3TFqaepHxdhBg==}
+
   fast-deep-equal@3.1.3:
     resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
 
@@ -4615,6 +4708,10 @@ packages:
     resolution: {integrity: sha512-7EyUlPFC0HOlBDpUFGfYstsU7XHxZJKAAMzCT8wZ0hMW7b+hG51LIKTDcsgtz8Pu6YC0HqRVbX+rVUtsGMUKvg==}
     engines: {node: '>=16.20'}
 
+  import-from-esm@2.0.0:
+    resolution: {integrity: sha512-YVt14UZCgsX1vZQ3gKjkWVdBdHQ6eu3MPU1TBgL1H5orXe2+jWD006WCPPtOuwlQm10NuzOW5WawiF1Q9veW8g==}
+    engines: {node: '>=18.20'}
+
   import-lazy@4.0.0:
     resolution: {integrity: sha512-rKtvo6a868b5Hu3heneU+L4yEQ4jYKLtjpnPeUdK7h0yzXGmyBTypknlkCvHFBqfX9YlorEiMM6Dnq/5atfHkw==}
     engines: {node: '>=8'}
@@ -5342,6 +5439,10 @@ packages:
     resolution: {integrity: sha512-BhXM0Au22RwUneMPwSCnyhTOizdWoIEPU9sp0Aqa1PnDMR5Wv2FGXYDjuzJEIX+Eo2Rb8xuYe5jrnm5QowQFkw==}
     engines: {node: '>=16.10'}
 
+  meow@13.2.0:
+    resolution: {integrity: sha512-pxQJQzB6djGPXh08dacEloMFopsOqGVRKFPYvPOt9XDZ1HasbgDZA74CJGreSU4G3Ak7EFJGoiH2auq+yXISgA==}
+    engines: {node: '>=18'}
+
   merge-descriptors@2.0.0:
     resolution: {integrity: sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==}
     engines: {node: '>=18'}
@@ -8733,6 +8834,8 @@ snapshots:
 
   '@octokit/auth-token@5.1.2': {}
 
+  '@octokit/auth-token@6.0.0': {}
+
   '@octokit/core@6.1.5':
     dependencies:
       '@octokit/auth-token': 5.1.2
@@ -8743,17 +8846,38 @@ snapshots:
       before-after-hook: 3.0.2
       universal-user-agent: 7.0.3
 
+  '@octokit/core@7.0.2':
+    dependencies:
+      '@octokit/auth-token': 6.0.0
+      '@octokit/graphql': 9.0.1
+      '@octokit/request': 10.0.3
+      '@octokit/request-error': 7.0.0
+      '@octokit/types': 14.1.0
+      before-after-hook: 4.0.0
+      universal-user-agent: 7.0.3
+
   '@octokit/endpoint@10.1.4':
     dependencies:
       '@octokit/types': 14.1.0
       universal-user-agent: 7.0.3
 
+  '@octokit/endpoint@11.0.0':
+    dependencies:
+      '@octokit/types': 14.1.0
+      universal-user-agent: 7.0.3
+
   '@octokit/graphql@8.2.2':
     dependencies:
       '@octokit/request': 9.2.4
       '@octokit/types': 14.1.0
       universal-user-agent: 7.0.3
 
+  '@octokit/graphql@9.0.1':
+    dependencies:
+      '@octokit/request': 10.0.3
+      '@octokit/types': 14.1.0
+      universal-user-agent: 7.0.3
+
   '@octokit/openapi-types@24.2.0': {}
 
   '@octokit/openapi-types@25.1.0': {}
@@ -8763,6 +8887,11 @@ snapshots:
       '@octokit/core': 6.1.5
       '@octokit/types': 13.10.0
 
+  '@octokit/plugin-paginate-rest@13.1.1(@octokit/core@7.0.2)':
+    dependencies:
+      '@octokit/core': 7.0.2
+      '@octokit/types': 14.1.0
+
   '@octokit/plugin-retry@7.2.1(@octokit/core@6.1.5)':
     dependencies:
       '@octokit/core': 6.1.5
@@ -8770,6 +8899,19 @@ snapshots:
       '@octokit/types': 14.1.0
       bottleneck: 2.19.5
 
+  '@octokit/plugin-retry@8.0.1(@octokit/core@7.0.2)':
+    dependencies:
+      '@octokit/core': 7.0.2
+      '@octokit/request-error': 7.0.0
+      '@octokit/types': 14.1.0
+      bottleneck: 2.19.5
+
+  '@octokit/plugin-throttling@11.0.1(@octokit/core@7.0.2)':
+    dependencies:
+      '@octokit/core': 7.0.2
+      '@octokit/types': 14.1.0
+      bottleneck: 2.19.5
+
   '@octokit/plugin-throttling@9.6.1(@octokit/core@6.1.5)':
     dependencies:
       '@octokit/core': 6.1.5
@@ -8780,6 +8922,18 @@ snapshots:
     dependencies:
       '@octokit/types': 14.1.0
 
+  '@octokit/request-error@7.0.0':
+    dependencies:
+      '@octokit/types': 14.1.0
+
+  '@octokit/request@10.0.3':
+    dependencies:
+      '@octokit/endpoint': 11.0.0
+      '@octokit/request-error': 7.0.0
+      '@octokit/types': 14.1.0
+      fast-content-type-parse: 3.0.0
+      universal-user-agent: 7.0.3
+
   '@octokit/request@9.2.4':
     dependencies:
       '@octokit/endpoint': 10.1.4
@@ -9268,6 +9422,20 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@semantic-release/commit-analyzer@13.0.1(semantic-release@23.1.1(typescript@5.8.3))':
+    dependencies:
+      conventional-changelog-angular: 8.0.0
+      conventional-changelog-writer: 8.1.0
+      conventional-commits-filter: 5.0.0
+      conventional-commits-parser: 6.2.0
+      debug: 4.4.1
+      import-from-esm: 2.0.0
+      lodash-es: 4.17.21
+      micromatch: 4.0.8
+      semantic-release: 23.1.1(typescript@5.8.3)
+    transitivePeerDependencies:
+      - supports-color
+
   '@semantic-release/error@3.0.0': {}
 
   '@semantic-release/error@4.0.0': {}
@@ -9320,6 +9488,28 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@semantic-release/github@11.0.3(semantic-release@23.1.1(typescript@5.8.3))':
+    dependencies:
+      '@octokit/core': 7.0.2
+      '@octokit/plugin-paginate-rest': 13.1.1(@octokit/core@7.0.2)
+      '@octokit/plugin-retry': 8.0.1(@octokit/core@7.0.2)
+      '@octokit/plugin-throttling': 11.0.1(@octokit/core@7.0.2)
+      '@semantic-release/error': 4.0.0
+      aggregate-error: 5.0.0
+      debug: 4.4.1
+      dir-glob: 3.0.1
+      globby: 14.1.0
+      http-proxy-agent: 7.0.2
+      https-proxy-agent: 7.0.6
+      issue-parser: 7.0.1
+      lodash-es: 4.17.21
+      mime: 4.0.7
+      p-filter: 4.1.0
+      semantic-release: 23.1.1(typescript@5.8.3)
+      url-join: 5.0.0
+    transitivePeerDependencies:
+      - supports-color
+
   '@semantic-release/npm@12.0.1(semantic-release@23.1.1(typescript@5.8.3))':
     dependencies:
       '@semantic-release/error': 4.0.0
@@ -9353,6 +9543,22 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@semantic-release/release-notes-generator@14.0.3(semantic-release@23.1.1(typescript@5.8.3))':
+    dependencies:
+      conventional-changelog-angular: 8.0.0
+      conventional-changelog-writer: 8.1.0
+      conventional-commits-filter: 5.0.0
+      conventional-commits-parser: 6.2.0
+      debug: 4.4.1
+      get-stream: 7.0.1
+      import-from-esm: 2.0.0
+      into-stream: 7.0.0
+      lodash-es: 4.17.21
+      read-package-up: 11.0.0
+      semantic-release: 23.1.1(typescript@5.8.3)
+    transitivePeerDependencies:
+      - supports-color
+
   '@shikijs/core@2.5.0':
     dependencies:
       '@shikijs/engine-javascript': 2.5.0
@@ -10618,6 +10824,8 @@ snapshots:
 
   before-after-hook@3.0.2: {}
 
+  before-after-hook@4.0.0: {}
+
   bidi-js@1.0.3:
     dependencies:
       require-from-string: 2.0.2
@@ -10864,6 +11072,10 @@ snapshots:
     dependencies:
       compare-func: 2.0.0
 
+  conventional-changelog-angular@8.0.0:
+    dependencies:
+      compare-func: 2.0.0
+
   conventional-changelog-writer@7.0.1:
     dependencies:
       conventional-commits-filter: 4.0.0
@@ -10873,8 +11085,17 @@ snapshots:
       semver: 7.7.2
       split2: 4.2.0
 
+  conventional-changelog-writer@8.1.0:
+    dependencies:
+      conventional-commits-filter: 5.0.0
+      handlebars: 4.7.8
+      meow: 13.2.0
+      semver: 7.7.2
+
   conventional-commits-filter@4.0.0: {}
 
+  conventional-commits-filter@5.0.0: {}
+
   conventional-commits-parser@5.0.0:
     dependencies:
       JSONStream: 1.3.5
@@ -10882,6 +11103,10 @@ snapshots:
       meow: 12.1.1
       split2: 4.2.0
 
+  conventional-commits-parser@6.2.0:
+    dependencies:
+      meow: 13.2.0
+
   convert-hrtime@5.0.0: {}
 
   convert-source-map@2.0.0: {}
@@ -11719,6 +11944,8 @@ snapshots:
 
   fast-content-type-parse@2.0.1: {}
 
+  fast-content-type-parse@3.0.0: {}
+
   fast-deep-equal@3.1.3: {}
 
   fast-diff@1.3.0: {}
@@ -12169,6 +12396,13 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  import-from-esm@2.0.0:
+    dependencies:
+      debug: 4.4.1
+      import-meta-resolve: 4.1.0
+    transitivePeerDependencies:
+      - supports-color
+
   import-lazy@4.0.0: {}
 
   import-local@3.2.0:
@@ -13086,6 +13320,8 @@ snapshots:
 
   meow@12.1.1: {}
 
+  meow@13.2.0: {}
+
   merge-descriptors@2.0.0: {}
 
   merge-stream@2.0.0: {}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 67b89bad..6dec9528 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -1,4 +1,4 @@
 packages:
-  # all packages in subdirs of packages/
-  - 'packages/*'
+  # all packages in subdirs of sdks/typescript/
+  - 'sdks/typescript/*'
   - 'examples/*'
diff --git a/release.config.js b/release.config.js
deleted file mode 100644
index 49dcd51c..00000000
--- a/release.config.js
+++ /dev/null
@@ -1,26 +0,0 @@
-module.exports = {
-  branches: ['main'],
-  plugins: [
-    '@semantic-release/commit-analyzer', // Analyzes commit messages
-    '@semantic-release/release-notes-generator', // Generates release notes
-    '@semantic-release/changelog', // Updates the CHANGELOG.md file
-    ['@semantic-release/npm', { npmPublish: true, pkgRoot: '.' }], // Publishes to npm, pkgRoot may need adjustment for monorepos
-    [
-      '@semantic-release/github',
-      {
-        assets: [
-          { path: 'dist/**', label: 'Distribution' }, // Example: adjust if you have artifacts to attach
-          { path: 'CHANGELOG.md', label: 'Changelog' },
-        ],
-      },
-    ], // Creates GitHub releases
-    [
-      '@semantic-release/git',
-      {
-        // Commits version bump and changelog
-        assets: ['package.json', 'pnpm-lock.yaml', 'CHANGELOG.md'], // Adjust if your lockfile is named differently
-        message: 'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
-      },
-    ],
-  ],
-};
diff --git a/sdks/ruby/.rspec b/sdks/ruby/.rspec
new file mode 100644
index 00000000..f6f85f5b
--- /dev/null
+++ b/sdks/ruby/.rspec
@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation
\ No newline at end of file
diff --git a/sdks/ruby/.rubocop.yml b/sdks/ruby/.rubocop.yml
new file mode 100644
index 00000000..a0f7bf8d
--- /dev/null
+++ b/sdks/ruby/.rubocop.yml
@@ -0,0 +1,27 @@
+AllCops:
+  NewCops: enable
+  Exclude:
+    - "bin/*"
+    - "vendor/**/*"
+    - "tmp/**/*"
+
+plugins:
+  - rubocop-rake
+  - rubocop-rspec
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/Documentation:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*.rb'
+    - '*.gemspec'
+
+RSpec/MultipleExpectations:
+  Enabled: false
diff --git a/sdks/ruby/Gemfile b/sdks/ruby/Gemfile
new file mode 100644
index 00000000..7f4f5e95
--- /dev/null
+++ b/sdks/ruby/Gemfile
@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
diff --git a/sdks/ruby/Gemfile.lock b/sdks/ruby/Gemfile.lock
new file mode 100644
index 00000000..2a1da01b
--- /dev/null
+++ b/sdks/ruby/Gemfile.lock
@@ -0,0 +1,75 @@
+PATH
+  remote: .
+  specs:
+    mcp_ui_server (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    diff-lcs (1.6.2)
+    json (2.12.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.4.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.0)
+    regexp_parser (2.10.0)
+    rspec (3.13.1)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.5)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.4)
+    rubocop (1.78.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.45.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.45.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.6.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  bundler
+  mcp_ui_server!
+  rake
+  rspec
+  rubocop
+  rubocop-rake
+  rubocop-rspec
+
+BUNDLED WITH
+   2.6.9
diff --git a/sdks/ruby/README.md b/sdks/ruby/README.md
new file mode 100644
index 00000000..05006301
--- /dev/null
+++ b/sdks/ruby/README.md
@@ -0,0 +1,182 @@
+# MCP UI Server SDK for Ruby
+
+This is the Ruby server-side SDK for MCP UI. It provides helper methods to create UI resources that can be sent to the mcp-ui client.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mcp_ui_server', git: 'https://github.com/idosal/mcp-ui'
+```
+
+And then execute:
+
+    $ bundle install
+
+## Usage
+
+The main method is `McpUiServer.create_ui_resource`. It helps you construct a valid UIResource hash.
+
+### URI Requirements
+
+All UI resources must use the `ui://` URI scheme. The SDK will validate it and raise a `McpUiServer::Error` if an invalid URI is provided.
+
+```ruby
+# Valid URI
+McpUiServer.create_ui_resource(uri: 'ui://my-app/greeting', ...)
+
+# Invalid URI - will raise McpUiServer::Error
+McpUiServer.create_ui_resource(uri: 'http://example.com', ...)
+```
+
+### Content Type Support
+
+The Ruby SDK follows Ruby conventions by using snake_case symbols for content types:
+
+- `:raw_html` - Raw HTML content
+- `:external_url` - External URL content  
+- `:remote_dom` - Remote DOM content
+
+The SDK maintains protocol consistency by internally mapping these to the camelCase format used in the MCP-UI specification.
+
+### Creating a `raw_html` resource
+
+```ruby
+require 'mcp_ui_server'
+
+resource = McpUiServer.create_ui_resource(
+  uri: 'ui://my-app/greeting',
+  content: {
+    type: :raw_html,
+    htmlString: '<h1>Hello, World!</h1>'
+  }
+)
+
+# The resulting resource hash can be serialized to JSON and sent in your API response.
+# {
+#   "type": "resource",
+#   "resource": {
+#     "uri": "ui://my-app/greeting",
+#     "mimeType": "text/html",
+#     "text": "<h1>Hello, World!</h1>"
+#   }
+# }
+```
+
+### Creating an `external_url` resource
+
+```ruby
+require 'mcp_ui_server'
+
+resource = McpUiServer.create_ui_resource(
+  uri: 'ui://my-app/external-page',
+  content: {
+    type: :external_url,
+    iframeUrl: 'https://example.com'
+  }
+)
+
+# Results in:
+# {
+#   "type": "resource",
+#   "resource": {
+#     "uri": "ui://my-app/external-page",
+#     "mimeType": "text/uri-list",
+#     "text": "https://example.com"
+#   }
+# }
+```
+
+### Creating a `remote_dom` resource
+
+```ruby
+require 'mcp_ui_server'
+
+script = "..." # Your javascript bundle for the remote-dom
+
+resource = McpUiServer.create_ui_resource(
+  uri: 'ui://my-app/complex-view',
+  content: {
+    type: :remote_dom,
+    script: script,
+    framework: :react # or :webcomponents
+  }
+)
+```
+
+### Using `blob` encoding
+
+For binary content or to avoid encoding issues, you can use `blob` encoding, which will Base64 encode the content.
+
+```ruby
+resource = McpUiServer.create_ui_resource(
+  uri: 'ui://my-app/greeting',
+  content: {
+    type: :raw_html,
+    htmlString: '<h1>Hello, World!</h1>'
+  },
+  encoding: :blob
+)
+```
+
+## Error Handling
+
+The SDK uses a custom `McpUiServer::Error` class for all SDK-specific errors. This makes it easy to rescue and handle SDK errors separately from other application errors.
+
+```ruby
+begin
+  resource = McpUiServer.create_ui_resource(
+    uri: 'http://invalid-scheme',
+    content: { type: :raw_html, htmlString: '<h1>Hello</h1>' }
+  )
+rescue McpUiServer::Error => e
+  puts "MCP UI SDK Error: #{e.message}"
+  # Handle SDK-specific errors
+rescue => e
+  puts "Other error: #{e.message}"
+  # Handle other errors
+end
+```
+
+Common error scenarios:
+- Invalid URI scheme (not starting with `ui://`)
+- Unknown content type (only `:raw_html`, `:external_url`, `:remote_dom` are supported)
+- Missing required content keys (e.g., `htmlString` for `raw_html`)
+- Unknown encoding type
+
+## Constants
+
+The SDK provides constants for MIME types and content types:
+
+```ruby
+# MIME type constants
+McpUiServer::MIME_TYPE_HTML          # 'text/html'
+McpUiServer::MIME_TYPE_URI_LIST      # 'text/uri-list'
+McpUiServer::MIME_TYPE_REMOTE_DOM    # 'application/vnd.mcp-ui.remote-dom; framework=%s'
+
+# Content type constants (Ruby snake_case)
+McpUiServer::CONTENT_TYPE_RAW_HTML      # :raw_html
+McpUiServer::CONTENT_TYPE_EXTERNAL_URL  # :external_url
+McpUiServer::CONTENT_TYPE_REMOTE_DOM    # :remote_dom
+
+# Protocol mapping (for internal use)
+McpUiServer::PROTOCOL_CONTENT_TYPES     # { raw_html: 'rawHtml', ... }
+
+# URI scheme constant
+McpUiServer::UI_URI_SCHEME           # 'ui://'
+```
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bundle exec rubocop` to check for code style.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/idosal/mcp-ui.
+
+## License
+
+The gem is available as open source under the terms of the [Apache-2.0 License](https://www.apache.org/licenses/LICENSE-2.0). 
\ No newline at end of file
diff --git a/sdks/ruby/Rakefile b/sdks/ruby/Rakefile
new file mode 100644
index 00000000..82bb534a
--- /dev/null
+++ b/sdks/ruby/Rakefile
@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
diff --git a/sdks/ruby/lib/mcp_ui_server.rb b/sdks/ruby/lib/mcp_ui_server.rb
new file mode 100644
index 00000000..8ba03b04
--- /dev/null
+++ b/sdks/ruby/lib/mcp_ui_server.rb
@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+require_relative 'mcp_ui_server/version'
+require 'base64'
+
+# The McpUiServer module provides helper methods for creating UI resources
+# compatible with the Model Context Protocol UI (mcp-ui) client.
+module McpUiServer
+  class Error < StandardError; end
+
+  # MIME type constants
+  MIME_TYPE_HTML = 'text/html'
+  MIME_TYPE_URI_LIST = 'text/uri-list'
+  MIME_TYPE_REMOTE_DOM = 'application/vnd.mcp-ui.remote-dom+javascript; framework=%s'
+
+  # Content type constants (Ruby snake_case)
+  CONTENT_TYPE_RAW_HTML = :raw_html
+  CONTENT_TYPE_EXTERNAL_URL = :external_url
+  CONTENT_TYPE_REMOTE_DOM = :remote_dom
+
+  # Protocol mapping (snake_case to camelCase for protocol consistency)
+  PROTOCOL_CONTENT_TYPES = {
+    raw_html: 'rawHtml',
+    external_url: 'externalUrl',
+    remote_dom: 'remoteDom'
+  }.freeze
+
+  # Required content keys for each content type
+  REQUIRED_CONTENT_KEYS = {
+    CONTENT_TYPE_RAW_HTML => :htmlString,
+    CONTENT_TYPE_EXTERNAL_URL => :iframeUrl,
+    CONTENT_TYPE_REMOTE_DOM => :script
+  }.freeze
+
+  # URI scheme constant
+  UI_URI_SCHEME = 'ui://'
+
+  # Creates a UIResource hash structure for an MCP response.
+  # This structure can then be serialized to JSON by your web framework.
+  #
+  # @param uri [String] The unique identifier for the resource (e.g., 'ui://greeting/1').
+  # @param content [Hash] A hash describing the UI content.
+  #   - :type [Symbol] The type of content. One of :raw_html, :external_url, or :remote_dom.
+  #   - :htmlString [String] The raw HTML content (required if type is :raw_html).
+  #   - :iframeUrl [String] The URL for an external page (required if type is :external_url).
+  #   - :script [String] The remote-dom script (required if type is :remote_dom).
+  #   - :framework [Symbol] The remote-dom framework, e.g., :react or :webcomponents (required, for :remote_dom).
+  # @param encoding [Symbol] The encoding method. :text for plain string, :blob for base64 encoded.
+  #
+  # @return [Hash] A UIResource hash ready to be included in an MCP response.
+  #
+  # @raise [McpUiServer::Error] if URI scheme is invalid, content type is unknown,
+  #   encoding type is unknown, or required content keys are missing.
+  def self.create_ui_resource(uri:, content:, encoding: :text)
+    validate_uri_scheme(uri)
+
+    resource = { uri: uri }
+
+    content_value = process_content(content, resource)
+    process_encoding(encoding, resource, content_value)
+
+    {
+      type: 'resource',
+      resource: resource
+    }
+  end
+
+  # private
+
+  def self.validate_uri_scheme(uri)
+    raise Error, "URI must start with '#{UI_URI_SCHEME}' but got: #{uri}" unless uri.start_with?(UI_URI_SCHEME)
+  end
+  private_class_method :validate_uri_scheme
+
+  def self.validate_content_type(content_type)
+    return if PROTOCOL_CONTENT_TYPES.key?(content_type)
+
+    supported_types = PROTOCOL_CONTENT_TYPES.keys.join(', ')
+    raise Error, "Unknown content type: #{content_type}. Supported types: #{supported_types}"
+  end
+  private_class_method :validate_content_type
+
+  def self.process_content(content, resource)
+    content_type = content.fetch(:type)
+    validate_content_type(content_type)
+
+    case content_type
+    when CONTENT_TYPE_RAW_HTML
+      process_raw_html_content(content, resource)
+    when CONTENT_TYPE_EXTERNAL_URL
+      process_external_url_content(content, resource)
+    when CONTENT_TYPE_REMOTE_DOM
+      process_remote_dom_content(content, resource)
+    end
+  end
+  private_class_method :process_content
+
+  def self.process_raw_html_content(content, resource)
+    resource[:mimeType] = MIME_TYPE_HTML
+    required_key = REQUIRED_CONTENT_KEYS[CONTENT_TYPE_RAW_HTML]
+    content.fetch(required_key) { raise Error, "Missing required key :#{required_key} for raw_html content" }
+  end
+  private_class_method :process_raw_html_content
+
+  def self.process_external_url_content(content, resource)
+    resource[:mimeType] = MIME_TYPE_URI_LIST
+    required_key = REQUIRED_CONTENT_KEYS[CONTENT_TYPE_EXTERNAL_URL]
+    content.fetch(required_key) { raise Error, "Missing required key :#{required_key} for external_url content" }
+  end
+  private_class_method :process_external_url_content
+
+  def self.process_remote_dom_content(content, resource)
+    framework = content.fetch(:framework) { raise Error, 'Missing required key :framework for remote_dom content' }
+    resource[:mimeType] = MIME_TYPE_REMOTE_DOM % framework
+    required_key = REQUIRED_CONTENT_KEYS[CONTENT_TYPE_REMOTE_DOM]
+    content.fetch(required_key) { raise Error, "Missing required key :#{required_key} for remote_dom content" }
+  end
+  private_class_method :process_remote_dom_content
+
+  def self.process_encoding(encoding, resource, content_value)
+    case encoding
+    when :text
+      resource[:text] = content_value
+    when :blob
+      resource[:blob] = Base64.strict_encode64(content_value)
+    else
+      raise Error, "Unknown encoding type: #{encoding}. Supported types: :text, :blob"
+    end
+  end
+  private_class_method :process_encoding
+end
diff --git a/sdks/ruby/lib/mcp_ui_server/version.rb b/sdks/ruby/lib/mcp_ui_server/version.rb
new file mode 100644
index 00000000..abfd096a
--- /dev/null
+++ b/sdks/ruby/lib/mcp_ui_server/version.rb
@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module McpUiServer
+  VERSION = '0.1.0'
+end
diff --git a/sdks/ruby/mcp_ui_server.gemspec b/sdks/ruby/mcp_ui_server.gemspec
new file mode 100644
index 00000000..79a14cfe
--- /dev/null
+++ b/sdks/ruby/mcp_ui_server.gemspec
@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative 'lib/mcp_ui_server/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = 'mcp_ui_server'
+  spec.version     = McpUiServer::VERSION
+  spec.authors     = ['Ido Salomon']
+  spec.email       = ['idosalomon@gmail.com']
+  spec.summary     = 'Ruby Server SDK for MCP UI'
+  spec.description = 'A Ruby server SDK for MCP UI.'
+  spec.homepage    = 'https://github.com/idosal/mcp-ui'
+  spec.license     = 'Apache-2.0'
+  spec.required_ruby_version = '>= 2.6.0'
+
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir['{lib}/**/*.rb', 'README.md']
+
+  spec.require_paths = ['lib']
+
+  # Add any runtime dependencies here
+  # spec.add_dependency "http"
+
+  # Add any development dependencies here
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rake'
+  spec.add_development_dependency 'rubocop-rspec'
+end
diff --git a/sdks/ruby/release.config.js b/sdks/ruby/release.config.js
new file mode 100644
index 00000000..23c3ae5d
--- /dev/null
+++ b/sdks/ruby/release.config.js
@@ -0,0 +1,36 @@
+module.exports = {
+  branches: ['main'],
+  tagFormat: 'ruby-server-sdk/v${version}',
+  plugins: [
+    '@semantic-release/commit-analyzer',
+    '@semantic-release/release-notes-generator',
+    [
+      '@semantic-release/changelog',
+      {
+        changelogFile: 'CHANGELOG.md',
+      },
+    ],
+    [
+      '@semantic-release/exec',
+      {
+        prepareCmd:
+          "sed -i 's/VERSION = \".*\"/VERSION = \"${nextRelease.version}\"/' lib/mcp_ui_server/version.rb && bundle install && gem build mcp_ui_server.gemspec",
+        publishCmd: 'gem push *.gem',
+      },
+    ],
+    [
+      '@semantic-release/github',
+      {
+        assets: '*.gem',
+      },
+    ],
+    [
+      '@semantic-release/git',
+      {
+        assets: ['CHANGELOG.md', 'lib/mcp_ui_server/version.rb', 'Gemfile.lock'],
+        message:
+          'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
+      },
+    ],
+  ],
+}; 
\ No newline at end of file
diff --git a/sdks/ruby/spec/mcp_ui_server_spec.rb b/sdks/ruby/spec/mcp_ui_server_spec.rb
new file mode 100644
index 00000000..0688c7f5
--- /dev/null
+++ b/sdks/ruby/spec/mcp_ui_server_spec.rb
@@ -0,0 +1,169 @@
+# frozen_string_literal: true
+
+require 'mcp_ui_server'
+require 'base64'
+
+RSpec.describe McpUiServer do
+  it 'has a version number' do
+    expect(McpUiServer::VERSION).not_to be_nil
+  end
+
+  describe '.create_ui_resource' do
+    let(:uri) { 'ui://test/1' }
+
+    context 'with raw_html content' do
+      let(:content) { { type: :raw_html, htmlString: '<h1>Hello</h1>' } }
+
+      it 'creates a resource with text/html mimetype and text encoding' do
+        resource = described_class.create_ui_resource(uri: uri, content: content)
+        expect(resource[:type]).to eq('resource')
+        expect(resource[:resource][:uri]).to eq(uri)
+        expect(resource[:resource][:mimeType]).to eq('text/html')
+        expect(resource[:resource][:text]).to eq('<h1>Hello</h1>')
+      end
+
+      it 'creates a resource with blob encoding' do
+        resource = described_class.create_ui_resource(uri: uri, content: content, encoding: :blob)
+        expect(resource[:resource][:blob]).to eq(Base64.strict_encode64('<h1>Hello</h1>'))
+      end
+    end
+
+    context 'with external_url content' do
+      let(:content) { { type: :external_url, iframeUrl: 'https://example.com' } }
+
+      it 'creates a resource with text/uri-list mimetype' do
+        resource = described_class.create_ui_resource(uri: uri, content: content)
+        expect(resource[:resource][:mimeType]).to eq('text/uri-list')
+        expect(resource[:resource][:text]).to eq('https://example.com')
+      end
+
+      it 'creates a resource with blob encoding' do
+        resource = described_class.create_ui_resource(uri: uri, content: content, encoding: :blob)
+        expect(resource[:resource][:blob]).to eq(Base64.strict_encode64('https://example.com'))
+      end
+    end
+
+    context 'with remote_dom content' do
+      let(:script) { 'console.log("hello")' }
+
+      it 'creates a resource with react framework' do
+        content = { type: :remote_dom, script: script, framework: :react }
+        resource = described_class.create_ui_resource(uri: uri, content: content)
+        expect(resource[:resource][:mimeType]).to eq('application/vnd.mcp-ui.remote-dom+javascript; framework=react')
+        expect(resource[:resource][:text]).to eq(script)
+      end
+
+      it 'creates a resource with a specified framework as a symbol' do
+        content = { type: :remote_dom, script: script, framework: :webcomponents }
+        resource = described_class.create_ui_resource(uri: uri, content: content)
+        expected_mime_type = 'application/vnd.mcp-ui.remote-dom+javascript; framework=webcomponents'
+        expect(resource[:resource][:mimeType]).to eq(expected_mime_type)
+      end
+
+      it 'creates a resource with a specified framework as a string' do
+        content = { type: :remote_dom, script: script, framework: 'react' }
+        resource = described_class.create_ui_resource(uri: uri, content: content)
+        expect(resource[:resource][:mimeType]).to eq('application/vnd.mcp-ui.remote-dom+javascript; framework=react')
+      end
+
+      it 'creates a resource with blob encoding' do
+        content = { type: :remote_dom, script: script, framework: :react }
+        resource = described_class.create_ui_resource(uri: uri, content: content, encoding: :blob)
+        expect(resource[:resource][:blob]).to eq(Base64.strict_encode64(script))
+      end
+
+      it 'creates a resource with blob encoding and a specified framework' do
+        content = { type: :remote_dom, script: script, framework: :webcomponents }
+        resource = described_class.create_ui_resource(uri: uri, content: content, encoding: :blob)
+        expected_mime_type = 'application/vnd.mcp-ui.remote-dom+javascript; framework=webcomponents'
+        expect(resource[:resource][:mimeType]).to eq(expected_mime_type)
+        expect(resource[:resource][:blob]).to eq(Base64.strict_encode64(script))
+      end
+    end
+
+    context 'with invalid input' do
+      it 'raises McpUiServer::Error for invalid URI scheme' do
+        invalid_uri = 'http://test/1'
+        content = { type: :raw_html, htmlString: '<h1>Hello</h1>' }
+        expect do
+          described_class.create_ui_resource(uri: invalid_uri, content: content)
+        end.to raise_error(McpUiServer::Error, "URI must start with 'ui://' but got: #{invalid_uri}")
+      end
+
+      it 'raises McpUiServer::Error for unknown content type' do
+        content = { type: :invalid, data: 'foo' }
+        expect do
+          described_class.create_ui_resource(uri: uri, content: content)
+        end.to raise_error(McpUiServer::Error, /Unknown content type: invalid/)
+      end
+
+      it 'raises McpUiServer::Error for camelCase string content type' do
+        content = { type: 'rawHtml', htmlString: '<h1>Hello</h1>' }
+        expect do
+          described_class.create_ui_resource(uri: uri, content: content)
+        end.to raise_error(McpUiServer::Error, /Unknown content type: rawHtml/)
+      end
+
+      it 'raises McpUiServer::Error for unknown encoding type' do
+        content = { type: :raw_html, htmlString: '<h1>Hello</h1>' }
+        expect do
+          described_class.create_ui_resource(uri: uri, content: content, encoding: :invalid)
+        end.to raise_error(McpUiServer::Error, /Unknown encoding type: invalid/)
+      end
+
+      it 'raises McpUiServer::Error if htmlString is missing' do
+        content = { type: :raw_html }
+        expect do
+          described_class.create_ui_resource(uri: uri, content: content)
+        end.to raise_error(McpUiServer::Error, /Missing required key :htmlString for raw_html content/)
+      end
+
+      it 'raises McpUiServer::Error if iframeUrl is missing' do
+        content = { type: :external_url }
+        expect do
+          described_class.create_ui_resource(uri: uri, content: content)
+        end.to raise_error(McpUiServer::Error, /Missing required key :iframeUrl for external_url content/)
+      end
+
+      it 'raises McpUiServer::Error if framework is missing' do
+        content = { type: :remote_dom, script: 'console.log("foo")' }
+        expect do
+          described_class.create_ui_resource(uri: uri, content: content)
+        end.to raise_error(McpUiServer::Error, /Missing required key :framework for remote_dom content/)
+      end
+
+      it 'raises McpUiServer::Error if script is missing' do
+        content = { type: :remote_dom, framework: :react }
+        expect do
+          described_class.create_ui_resource(uri: uri, content: content)
+        end.to raise_error(McpUiServer::Error, /Missing required key :script for remote_dom content/)
+      end
+    end
+
+    context 'with constants' do
+      it 'defines expected MIME type constants' do
+        expect(McpUiServer::MIME_TYPE_HTML).to eq('text/html')
+        expect(McpUiServer::MIME_TYPE_URI_LIST).to eq('text/uri-list')
+        expect(McpUiServer::MIME_TYPE_REMOTE_DOM).to eq('application/vnd.mcp-ui.remote-dom+javascript; framework=%s')
+      end
+
+      it 'defines expected content type constants' do
+        expect(McpUiServer::CONTENT_TYPE_RAW_HTML).to eq(:raw_html)
+        expect(McpUiServer::CONTENT_TYPE_EXTERNAL_URL).to eq(:external_url)
+        expect(McpUiServer::CONTENT_TYPE_REMOTE_DOM).to eq(:remote_dom)
+      end
+
+      it 'defines protocol content type mapping' do
+        expect(McpUiServer::PROTOCOL_CONTENT_TYPES).to include(
+          raw_html: 'rawHtml',
+          external_url: 'externalUrl',
+          remote_dom: 'remoteDom'
+        )
+      end
+
+      it 'defines URI scheme constant' do
+        expect(McpUiServer::UI_URI_SCHEME).to eq('ui://')
+      end
+    end
+  end
+end
diff --git a/sdks/ruby/spec/spec_helper.rb b/sdks/ruby/spec/spec_helper.rb
new file mode 100644
index 00000000..9b363e6b
--- /dev/null
+++ b/sdks/ruby/spec/spec_helper.rb
@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to be loaded before any of your specs are run.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text argument names
+    # that match what was passed in an expectation. For example:
+    #     be_bigger_than(2).and(be_smaller_than(4)).description
+    #     # => "be bigger than 2 and be smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than and be smaller than"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+end
diff --git a/packages/client/README.md b/sdks/typescript/client/README.md
similarity index 76%
rename from packages/client/README.md
rename to sdks/typescript/client/README.md
index 83faaa1a..dae93193 100644
--- a/packages/client/README.md
+++ b/sdks/typescript/client/README.md
@@ -7,6 +7,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/@mcp-ui/server"><img src="https://img.shields.io/npm/v/@mcp-ui/server?label=server&color=green" alt="Server Version"></a>
   <a href="https://www.npmjs.com/package/@mcp-ui/client"><img src="https://img.shields.io/npm/v/@mcp-ui/client?label=client&color=blue" alt="Client Version"></a>
+  <a href="https://rubygems.org/gems/mcp_ui_server"><img src="https://img.shields.io/gem/v/mcp_ui_server?label=ruby-server&color=red" alt="Ruby Server SDK Version"></a>
   <a href="https://gitmcp.io/idosal/mcp-ui"><img src="https://img.shields.io/endpoint?url=https://gitmcp.io/badge/idosal/mcp-ui" alt="MCP Documentation"></a>
 </p>
 
@@ -34,10 +35,11 @@
 
 ## 💡 What's `mcp-ui`?
 
-`mcp-ui` is a TypeScript SDK comprising two packages:
+`mcp-ui` is a collection of SDKs comprising:
 
-* **`@mcp-ui/server`**: Utilities to generate UI resources (`UIResource`) on your MCP server.
-* **`@mcp-ui/client`**: UI components (e.g., `<UIResourceRenderer />`) to render the UI resources and handle their events.
+* **`@mcp-ui/server` (TypeScript)**: Utilities to generate UI resources (`UIResource`) on your MCP server.
+* **`@mcp-ui/client` (TypeScript)**: UI components (e.g., `<UIResourceRenderer />`) to render the UI resources and handle their events.
+* **`mcp_ui_server` (Ruby)**: Utilities to generate UI resources on your MCP server in a Ruby environment.
 
 Together, they let you define reusable UI snippets on the server side, seamlessly and securely render them in the client, and react to their actions in the MCP host environment.
 
@@ -71,7 +73,7 @@ interface UIResource {
 The UI Resource is rendered in the `<UIResourceRenderer />` component. It automatically detects the resource type and renders the appropriate component.
 
 It accepts the following props:
-- **`resource`**: The resource object from an MCP response. Should include `uri`, `mimeType`, and content (`text`, `blob`, or `content`)
+- **`resource`**: The resource object from an MCP Tool response. It must include `uri`, `mimeType`, and content (`text`, `blob`)
 - **`onUIAction`**: Optional callback for handling UI actions from the resource:
   ```typescript
   { type: 'tool', payload: { toolName: string, params: Record<string, unknown> }, messageId?: string } |
@@ -93,7 +95,7 @@ It accepts the following props:
 
 #### HTML (`text/html` and `text/uri-list`)
 
-Rendered using the `<HTMLResourceRenderer />` component, which displays content inside an `<iframe>`. This is suitable for self-contained HTML or embedding external apps.
+Rendered using the internal `<HTMLResourceRenderer />` component, which displays content inside an `<iframe>`. This is suitable for self-contained HTML or embedding external apps.
 
 *   **`mimeType`**:
     *   `text/html`: Renders inline HTML content.
@@ -101,16 +103,18 @@ Rendered using the `<HTMLResourceRenderer />` component, which displays content
 
 #### Remote DOM (`application/vnd.mcp-ui.remote-dom`)
 
-Rendered using the `<RemoteDOMResourceRenderer />` component, which uses Shopify's [`remote-dom`](https://github.com/Shopify/remote-dom). The server responds with a script that describes the UI and events. On the host, the script is securely rendered in a sandboxed iframe, and the UI changes are communicated to the host in JSON, where they're rendered using the host's component library. This is more flexible than iframes and allows for UIs that match the host's look-and-feel.
+Rendered using the internal `<RemoteDOMResourceRenderer />` component, which utilizes Shopify's [`remote-dom`](https://github.com/Shopify/remote-dom). The server responds with a script that describes the UI and events. On the host, the script is securely rendered in a sandboxed iframe, and the UI changes are communicated to the host in JSON, where they're rendered using the host's component library. This is more flexible than iframes and allows for UIs that match the host's look-and-feel.
 
 * **`mimeType`**: `application/vnd.mcp-ui.remote-dom+javascript; framework={react | webcomponents}`
 
 ### UI Action
 
-UI snippets must be able to interact with the agent. In `mcp-ui`, this is done by hooking into events sent from the UI snippet and reacting to them in the host. For example, an HTML may trigger a tool call when a button is clicked by sending an event which will be caught handled by the client.
+UI snippets must be able to interact with the agent. In `mcp-ui`, this is done by hooking into events sent from the UI snippet and reacting to them in the host (see `onUIAction` prop). For example, an HTML may trigger a tool call when a button is clicked by sending an event which will be caught handled by the client.
 
 ## 🏗️ Installation
 
+### TypeScript
+
 ```bash
 # using npm
 npm install @mcp-ui/server @mcp-ui/client
@@ -122,11 +126,19 @@ pnpm add @mcp-ui/server @mcp-ui/client
 yarn add @mcp-ui/server @mcp-ui/client
 ```
 
+### Ruby
+
+```bash
+gem install mcp_ui_server
+```
+
 ## 🎬 Quickstart
 
 You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to `mcp-ui`'s latest documentation! 
 
-1. **Server-side**: Build your resource blocks
+### TypeScript
+
+1. **Server-side**: Build your UI resources
 
    ```ts
    import { createUIResource } from '@mcp-ui/server';
@@ -185,7 +197,6 @@ You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to
            resource={mcpResource.resource}
            onUIAction={(result) => {
              console.log('Action:', result);
-             return { status: 'ok' };
            }}
          />
        );
@@ -194,7 +205,45 @@ You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to
    }
    ```
 
-3. **Enjoy** interactive MCP UI — no extra configuration required.
+### Ruby
+
+**Server-side**: Build your UI resources
+
+   ```ruby
+   require 'mcp_ui_server'
+
+   # Inline HTML
+   html_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://greeting/1',
+     content: { type: :raw_html, htmlString: '<p>Hello, from Ruby!</p>' },
+     encoding: :text
+   )
+
+   # External URL
+   external_url_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://greeting/2',
+     content: { type: :external_url, iframeUrl: 'https://example.com' },
+     encoding: :text
+   )
+
+   # remote-dom
+   remote_dom_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://remote-component/action-button',
+     content: {
+       type: :remote_dom,
+       script: "
+        const button = document.createElement('ui-button');
+        button.setAttribute('label', 'Click me from Ruby!');
+        button.addEventListener('press', () => {
+          window.parent.postMessage({ type: 'tool', payload: { toolName: 'uiInteraction', params: { action: 'button-click', from: 'ruby-remote-dom' } } }, '*');
+        });
+        root.appendChild(button);
+        ",
+       framework: :react,
+     },
+     encoding: :text
+   )
+   ```
 
 ## 🌍 Examples
 
@@ -223,7 +272,7 @@ Host and user security is one of `mcp-ui`'s primary concerns. In all content typ
 - [X] Support Web Components
 - [X] Support Remote-DOM
 - [ ] Add component libraries (in progress)
-- [ ] Add SDKs for additional programming languages (in progress)
+- [ ] Add SDKs for additional programming languages (in progress; Ruby available)
 - [ ] Support additional frontend frameworks
 - [ ] Add declarative UI content type
 - [ ] Support generative UI?
diff --git a/packages/client/package.json b/sdks/typescript/client/package.json
similarity index 67%
rename from packages/client/package.json
rename to sdks/typescript/client/package.json
index ab2cc076..900a0333 100644
--- a/packages/client/package.json
+++ b/sdks/typescript/client/package.json
@@ -48,5 +48,32 @@
   "publishConfig": {
     "access": "public"
   },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      [
+        "@semantic-release/changelog",
+        {
+          "changelogFile": "CHANGELOG.md"
+        }
+      ],
+      "@semantic-release/npm",
+      "@semantic-release/github",
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "CHANGELOG.md",
+            "package.json"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]\\n\\n${nextRelease.notes}"
+        }
+      ]
+    ]
+  },
   "license": "Apache-2.0"
 }
diff --git a/packages/client/scripts/bundle-iframe.js b/sdks/typescript/client/scripts/bundle-iframe.js
similarity index 100%
rename from packages/client/scripts/bundle-iframe.js
rename to sdks/typescript/client/scripts/bundle-iframe.js
diff --git a/packages/client/scripts/iframe-entry.js b/sdks/typescript/client/scripts/iframe-entry.js
similarity index 100%
rename from packages/client/scripts/iframe-entry.js
rename to sdks/typescript/client/scripts/iframe-entry.js
diff --git a/packages/client/scripts/proxy/index.html b/sdks/typescript/client/scripts/proxy/index.html
similarity index 100%
rename from packages/client/scripts/proxy/index.html
rename to sdks/typescript/client/scripts/proxy/index.html
diff --git a/packages/client/src/components/HTMLResourceRenderer.tsx b/sdks/typescript/client/src/components/HTMLResourceRenderer.tsx
similarity index 100%
rename from packages/client/src/components/HTMLResourceRenderer.tsx
rename to sdks/typescript/client/src/components/HTMLResourceRenderer.tsx
diff --git a/packages/client/src/components/RemoteDOMRenderer.tsx b/sdks/typescript/client/src/components/RemoteDOMRenderer.tsx
similarity index 100%
rename from packages/client/src/components/RemoteDOMRenderer.tsx
rename to sdks/typescript/client/src/components/RemoteDOMRenderer.tsx
diff --git a/packages/client/src/components/RemoteDOMResourceRenderer.tsx b/sdks/typescript/client/src/components/RemoteDOMResourceRenderer.tsx
similarity index 100%
rename from packages/client/src/components/RemoteDOMResourceRenderer.tsx
rename to sdks/typescript/client/src/components/RemoteDOMResourceRenderer.tsx
diff --git a/packages/client/src/components/UIResourceRenderer.tsx b/sdks/typescript/client/src/components/UIResourceRenderer.tsx
similarity index 100%
rename from packages/client/src/components/UIResourceRenderer.tsx
rename to sdks/typescript/client/src/components/UIResourceRenderer.tsx
diff --git a/packages/client/src/components/__tests__/HTMLResourceRenderer.test.tsx b/sdks/typescript/client/src/components/__tests__/HTMLResourceRenderer.test.tsx
similarity index 100%
rename from packages/client/src/components/__tests__/HTMLResourceRenderer.test.tsx
rename to sdks/typescript/client/src/components/__tests__/HTMLResourceRenderer.test.tsx
diff --git a/packages/client/src/components/__tests__/RemoteDOMResourceRenderer.test.tsx b/sdks/typescript/client/src/components/__tests__/RemoteDOMResourceRenderer.test.tsx
similarity index 100%
rename from packages/client/src/components/__tests__/RemoteDOMResourceRenderer.test.tsx
rename to sdks/typescript/client/src/components/__tests__/RemoteDOMResourceRenderer.test.tsx
diff --git a/packages/client/src/components/__tests__/UIResourceRenderer.test.tsx b/sdks/typescript/client/src/components/__tests__/UIResourceRenderer.test.tsx
similarity index 100%
rename from packages/client/src/components/__tests__/UIResourceRenderer.test.tsx
rename to sdks/typescript/client/src/components/__tests__/UIResourceRenderer.test.tsx
diff --git a/packages/client/src/components/__tests__/UIResourceRenderer.unmocked.test.tsx b/sdks/typescript/client/src/components/__tests__/UIResourceRenderer.unmocked.test.tsx
similarity index 100%
rename from packages/client/src/components/__tests__/UIResourceRenderer.unmocked.test.tsx
rename to sdks/typescript/client/src/components/__tests__/UIResourceRenderer.unmocked.test.tsx
diff --git a/packages/client/src/index.ts b/sdks/typescript/client/src/index.ts
similarity index 100%
rename from packages/client/src/index.ts
rename to sdks/typescript/client/src/index.ts
diff --git a/packages/client/src/remote-dom/component-libraries/basic.tsx b/sdks/typescript/client/src/remote-dom/component-libraries/basic.tsx
similarity index 100%
rename from packages/client/src/remote-dom/component-libraries/basic.tsx
rename to sdks/typescript/client/src/remote-dom/component-libraries/basic.tsx
diff --git a/packages/client/src/remote-dom/iframe-bundle.ts b/sdks/typescript/client/src/remote-dom/iframe-bundle.ts
similarity index 95%
rename from packages/client/src/remote-dom/iframe-bundle.ts
rename to sdks/typescript/client/src/remote-dom/iframe-bundle.ts
index 26794e4e..b7367f47 100644
--- a/packages/client/src/remote-dom/iframe-bundle.ts
+++ b/sdks/typescript/client/src/remote-dom/iframe-bundle.ts
@@ -23,7 +23,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
   var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
   var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
 
-  // ../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/RemoteEvent.mjs
+  // ../../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/RemoteEvent.mjs
   var RemoteEvent = class extends CustomEvent {
     /**
      * The last value received from a \`respondWith()\` call.
@@ -37,7 +37,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     }
   };
 
-  // ../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/constants.mjs
+  // ../../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/constants.mjs
   var MUTATION_TYPE_INSERT_CHILD = 0;
   var MUTATION_TYPE_REMOVE_CHILD = 1;
   var MUTATION_TYPE_UPDATE_TEXT = 2;
@@ -47,7 +47,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
   var UPDATE_PROPERTY_TYPE_EVENT_LISTENER = 3;
   var ROOT_ID = "~";
 
-  // ../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/internals.mjs
+  // ../../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/internals.mjs
   var REMOTE_CONNECTIONS = /* @__PURE__ */ new WeakMap();
   var REMOTE_IDS = /* @__PURE__ */ new WeakMap();
   var id = 0;
@@ -192,7 +192,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     return connection.call(id2, method, ...args);
   }
 
-  // ../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/RemoteElement.mjs
+  // ../../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/RemoteElement.mjs
   var EMPTY_DEFINITION = Object.freeze({});
   var RemoteElement = class extends HTMLElement {
     static get observedAttributes() {
@@ -671,7 +671,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
   function noopBubblesEventListener() {
   }
 
-  // ../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/RemoteMutationObserver.mjs
+  // ../../../node_modules/.pnpm/@remote-dom+core@1.8.1_@preact+signals-core@1.10.0/node_modules/@remote-dom/core/build/esm/elements/RemoteMutationObserver.mjs
   var RemoteMutationObserver = class extends MutationObserver {
     constructor(connection) {
       super((records) => {
@@ -737,7 +737,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     return -1;
   }
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/constants.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/constants.mjs
   var MESSAGE_CALL = 1;
   var MESSAGE_CALL_RESULT = 2;
   var MESSAGE_FUNCTION_CALL = 3;
@@ -746,7 +746,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
   var SERIALIZE_METHOD = Symbol.for("quilt.threads.serialize");
   var TRANSFERABLE = Symbol.for("quilt.threads.transferable");
 
-  // ../../node_modules/.pnpm/@quilted+events@2.1.3/node_modules/@quilted/events/build/esm/abort/NestedAbortController.mjs
+  // ../../../node_modules/.pnpm/@quilted+events@2.1.3/node_modules/@quilted/events/build/esm/abort/NestedAbortController.mjs
   var NestedAbortController = class extends AbortController {
     constructor(...parents) {
       super();
@@ -765,14 +765,14 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     }
   };
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/errors.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/errors.mjs
   var ThreadClosedError = class extends Error {
     constructor() {
       super("You attempted to call a function on a closed thread.");
     }
   };
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/nanoid.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/nanoid.mjs
   var a = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
   function nanoid(e = 21) {
     let t = "", r = crypto.getRandomValues(new Uint8Array(e));
@@ -780,7 +780,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     return t;
   }
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/functions/ThreadFunctionsAutomatic.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/functions/ThreadFunctionsAutomatic.mjs
   var _functionsToId, _idsToFunction, _idsToProxy, _finalization, _ThreadFunctionsAutomatic_instances, finalizationRegistry_fn;
   var ThreadFunctionsAutomatic = class {
     constructor() {
@@ -845,7 +845,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     return finalization;
   };
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/serialization/shared.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/serialization/shared.mjs
   function isIterator(value) {
     return value != null && (Symbol.asyncIterator in value || Symbol.iterator in value) && typeof value.next === "function";
   }
@@ -855,7 +855,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     return prototype == null || prototype === Object.prototype;
   }
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/serialization/ThreadSerializationStructuredClone.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/serialization/ThreadSerializationStructuredClone.mjs
   var FUNCTION = "_@f";
   var ASYNC_ITERATOR = "_@i";
   var _customSerializer, _customDeserializer, _ThreadSerializationStructuredClone_instances, serializeInternal_fn, deserializeInternal_fn;
@@ -997,7 +997,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     return value;
   };
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/Thread.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/Thread.mjs
   var _abort, _idsToResolver, _Thread_instances, callLocal_fn, handlerForCall_fn, resolveCall_fn, waitForResult_fn;
   var Thread = class {
     constructor(messages, {
@@ -1216,11 +1216,11 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     throw new Error(\`You attempted to call a function that is not stored. It may have already been released.\`);
   }
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/threads/window/shared.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/threads/window/shared.mjs
   var CHECK_MESSAGE = "quilt.threads.ping";
   var RESPONSE_MESSAGE = "quilt.threads.pong";
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/threads/window/ThreadNestedWindow.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/threads/window/ThreadNestedWindow.mjs
   function nestedWindowToThreadTarget(parent, {
     targetOrigin = "*"
   } = {}) {
@@ -1261,7 +1261,7 @@ export const IFRAME_SRC_DOC = `<!DOCTYPE html>
     };
   }
 
-  // ../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/threads/ThreadNestedIframe.mjs
+  // ../../../node_modules/.pnpm/@quilted+threads@3.1.3_@preact+signals-core@1.10.0/node_modules/@quilted/threads/build/esm/threads/ThreadNestedIframe.mjs
   var ThreadNestedIframe = class extends Thread {
     constructor({
       parent = globalThis.parent,
diff --git a/packages/client/src/remote-dom/remote-elements/index.ts b/sdks/typescript/client/src/remote-dom/remote-elements/index.ts
similarity index 100%
rename from packages/client/src/remote-dom/remote-elements/index.ts
rename to sdks/typescript/client/src/remote-dom/remote-elements/index.ts
diff --git a/packages/client/src/test-setup.ts b/sdks/typescript/client/src/test-setup.ts
similarity index 100%
rename from packages/client/src/test-setup.ts
rename to sdks/typescript/client/src/test-setup.ts
diff --git a/packages/client/src/types.ts b/sdks/typescript/client/src/types.ts
similarity index 100%
rename from packages/client/src/types.ts
rename to sdks/typescript/client/src/types.ts
diff --git a/sdks/typescript/client/src/utils/__tests__/processResource.test.ts b/sdks/typescript/client/src/utils/__tests__/processResource.test.ts
new file mode 100644
index 00000000..a1553ccb
--- /dev/null
+++ b/sdks/typescript/client/src/utils/__tests__/processResource.test.ts
@@ -0,0 +1,300 @@
+import { describe, it, expect, vi } from 'vitest';
+import { processHTMLResource, processRemoteDOMResource } from '../processResource';
+
+describe('processHTMLResource', () => {
+  describe('text/uri-list', () => {
+    it('should process a valid https URL from text', () => {
+      const resource = {
+        mimeType: 'text/uri-list' as const,
+        text: 'https://example.com',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBeUndefined();
+      expect(result.iframeSrc).toBe('https://example.com');
+      expect(result.iframeRenderMode).toBe('src');
+    });
+
+    it('should process a valid http URL', () => {
+      const resource = {
+        mimeType: 'text/uri-list',
+        text: 'http://example.com',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBeUndefined();
+      expect(result.iframeSrc).toBe('http://example.com');
+      expect(result.iframeRenderMode).toBe('src');
+    });
+
+    it('should return an error for an invalid URL (javascript:alert)', () => {
+      const resource = {
+        mimeType: 'text/uri-list',
+        text: 'javascript:alert("pwned")',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('No valid URLs found in uri-list content.');
+      expect(result.iframeSrc).toBeUndefined();
+    });
+
+    it('should return an error for a blob URL', () => {
+      const resource = {
+        mimeType: 'text/uri-list',
+        text: 'blob:https://example.com/some-uuid',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('No valid URLs found in uri-list content.');
+      expect(result.iframeSrc).toBeUndefined();
+    });
+
+    it('should extract the first valid URL from a list', () => {
+      const resource = {
+        mimeType: 'text/uri-list',
+        text: '# comment\ninvalid-url\nhttps://first-valid.com\nhttps://second-valid.com',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBeUndefined();
+      expect(result.iframeSrc).toBe('https://first-valid.com');
+    });
+
+    it('should handle empty or commented-out content', () => {
+      const resource = {
+        mimeType: 'text/uri-list',
+        text: '# just a comment\n# another comment',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('No valid URLs found in uri-list content.');
+    });
+
+    it('should return error for content with no valid URLs', () => {
+      const resource = {
+        mimeType: 'text/uri-list',
+        text: 'just-some-string\nanother-string',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('No valid URLs found in uri-list content.');
+    });
+
+    it('should process a valid https URL from blob', () => {
+      const resource = {
+        mimeType: 'text/uri-list' as const,
+        blob: btoa('https://example.com'),
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBeUndefined();
+      expect(result.iframeSrc).toBe('https://example.com');
+      expect(result.iframeRenderMode).toBe('src');
+    });
+
+    it('should return an error for invalid blob content', () => {
+      const resource = {
+        mimeType: 'text/uri-list' as const,
+        blob: 'not-base64',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('Error decoding URL from blob.');
+      expect(result.iframeSrc).toBeUndefined();
+    });
+
+    it('should return an error for missing text and blob', () => {
+      const resource = {
+        mimeType: 'text/uri-list' as const,
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe(
+        'URL resource expects a non-empty text or blob field containing the URL.',
+      );
+    });
+
+    it('should return an error for empty text content', () => {
+      const resource = {
+        mimeType: 'text/uri-list' as const,
+        text: ' ',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('URL resource expects a non-empty text or blob field containing the URL.');
+    });
+
+    it('should extract the first valid URL from a blob', () => {
+      const resource = {
+        mimeType: 'text/uri-list' as const,
+        blob: btoa('# comment\ninvalid-url\nhttps://first-valid.com\nhttps://second-valid.com'),
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBeUndefined();
+      expect(result.iframeSrc).toBe('https://first-valid.com');
+    });
+
+    it('should warn when multiple URLs are provided and use the first one', () => {
+      const consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+      const resource = {
+        mimeType: 'text/uri-list' as const,
+        text: 'https://first-valid.com\nhttps://second-valid.com',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.iframeSrc).toBe('https://first-valid.com');
+      expect(consoleWarnSpy).toHaveBeenCalledWith(
+        'Multiple URLs found in uri-list content. Using the first URL: "https://first-valid.com". Other URLs ignored:',
+        ['https://second-valid.com'],
+      );
+      consoleWarnSpy.mockRestore();
+    });
+  });
+
+  describe('text/html', () => {
+    it('should process HTML from text content', () => {
+      const html = '<h1>Hello World</h1>';
+      const resource = {
+        mimeType: 'text/html' as const,
+        text: html,
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBeUndefined();
+      expect(result.htmlString).toBe(html);
+      expect(result.iframeRenderMode).toBe('srcDoc');
+    });
+
+    it('should process HTML from blob content', () => {
+      const html = '<h1>Hello from Blob</h1>';
+      const resource = {
+        mimeType: 'text/html' as const,
+        blob: btoa(html),
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBeUndefined();
+      expect(result.htmlString).toBe(html);
+      expect(result.iframeRenderMode).toBe('srcDoc');
+    });
+
+    it('should return an error for invalid blob content', () => {
+      const resource = {
+        mimeType: 'text/html' as const,
+        blob: 'not-base64',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('Error decoding HTML content from blob.');
+      expect(result.htmlString).toBeUndefined();
+    });
+
+    it('should return an error for missing text and blob', () => {
+      const resource = {
+        mimeType: 'text/html' as const,
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe('HTML resource requires text or blob content.');
+    });
+
+    describe('proxy', () => {
+      it('should use proxy when provided for external URLs', () => {
+        const resource = {
+          mimeType: 'text/uri-list',
+          text: 'https://example.com',
+        };
+        const result = processHTMLResource(resource, 'https://proxy.mcpui.dev/');
+        expect(result.error).toBeUndefined();
+        expect(result.iframeSrc).toBe('https://proxy.mcpui.dev/?url=https%3A%2F%2Fexample.com');
+        expect(result.iframeRenderMode).toBe('src');
+      });
+    
+      it('should handle proxy with existing query parameters', () => {
+        const resource = {
+          mimeType: 'text/uri-list',
+          text: 'https://example.com',
+        };
+        const result = processHTMLResource(resource, 'https://proxy.mcpui.dev/?a=1&b=2');
+        expect(result.error).toBeUndefined();
+        expect(result.iframeSrc).toBe('https://proxy.mcpui.dev/?a=1&b=2&url=https%3A%2F%2Fexample.com');
+        expect(result.iframeRenderMode).toBe('src');
+      });
+    
+      it('should fallback to direct URL if proxy is invalid', () => {
+        const resource = {
+          mimeType: 'text/uri-list',
+          text: 'https://example.com',
+        };
+        const result = processHTMLResource(resource, 'not-a-valid-url');
+        expect(result.error).toBeUndefined();
+        expect(result.iframeSrc).toBe('https://example.com');
+        expect(result.iframeRenderMode).toBe('src');
+      });
+    
+      it('should not use proxy when proxy is empty string', () => {
+        const resource = {
+          mimeType: 'text/uri-list',
+          text: 'https://example.com',
+        };
+        const result = processHTMLResource(resource, '');
+        expect(result.error).toBeUndefined();
+        expect(result.iframeSrc).toBe('https://example.com');
+        expect(result.iframeRenderMode).toBe('src');
+      });
+    
+      it('should not use proxy when proxy is not provided', () => {
+        const resource = {
+          mimeType: 'text/uri-list',
+          text: 'https://example.com',
+        };
+        const result = processHTMLResource(resource);
+        expect(result.error).toBeUndefined();
+        expect(result.iframeSrc).toBe('https://example.com');
+        expect(result.iframeRenderMode).toBe('src');
+      });
+    });
+  });
+
+  describe('Unsupported mimeType', () => {
+    it('should return an error for an unsupported mimeType', () => {
+      const resource = {
+        mimeType: 'application/json' as const,
+        text: '{}',
+      };
+      const result = processHTMLResource(resource);
+      expect(result.error).toBe(
+        'Resource must be of type text/html (for HTML content) or text/uri-list (for URL content).',
+      );
+    });
+  });
+});
+
+describe('processRemoteDOMResource', () => {
+  it('should process code from text content', () => {
+    const code = 'const el = 1;';
+    const resource = {
+      text: code,
+    };
+    const result = processRemoteDOMResource(resource);
+    expect(result.error).toBeUndefined();
+    expect(result.code).toBe(code);
+  });
+
+  it('should process code from blob content', () => {
+    const code = 'const el = 2;';
+    const resource = {
+      blob: btoa(code),
+    };
+    const result = processRemoteDOMResource(resource);
+    expect(result.error).toBeUndefined();
+    expect(result.code).toBe(code);
+  });
+
+  it('should return an error for invalid blob content', () => {
+    const resource = {
+      blob: 'not-base64',
+    };
+    const result = processRemoteDOMResource(resource);
+    expect(result.error).toBe('Error decoding remote DOM content from blob.');
+    expect(result.code).toBeUndefined();
+  });
+
+  it('should return an error for missing text and blob', () => {
+    const resource = {};
+    const result = processRemoteDOMResource(resource);
+    expect(result.error).toBe('Remote DOM resource requires non-empty text or blob content.');
+  });
+
+  it('should return an error for empty text content', () => {
+    const resource = {
+      text: '   ',
+    };
+    const result = processRemoteDOMResource(resource);
+    expect(result.error).toBe('Remote DOM resource requires non-empty text or blob content.');
+  });
+});
diff --git a/packages/client/src/utils/processResource.ts b/sdks/typescript/client/src/utils/processResource.ts
similarity index 99%
rename from packages/client/src/utils/processResource.ts
rename to sdks/typescript/client/src/utils/processResource.ts
index 7fba442b..c1f9cdd1 100644
--- a/packages/client/src/utils/processResource.ts
+++ b/sdks/typescript/client/src/utils/processResource.ts
@@ -59,7 +59,7 @@ export function processHTMLResource(
         error: 'URL content is empty.',
       };
     }
-
+    
     // Parse uri-list format: URIs separated by newlines, comments start with #
     // MCP-UI requires a single URL - if multiple are found, use first and warn about others
     const lines = urlContent
diff --git a/packages/client/tsconfig.json b/sdks/typescript/client/tsconfig.json
similarity index 80%
rename from packages/client/tsconfig.json
rename to sdks/typescript/client/tsconfig.json
index 0167ca79..4117020e 100644
--- a/packages/client/tsconfig.json
+++ b/sdks/typescript/client/tsconfig.json
@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../../tsconfig.base.json",
   "compilerOptions": {
     "jsx": "react-jsx",
     "forceConsistentCasingInFileNames": true
diff --git a/packages/client/vite.config.ts b/sdks/typescript/client/vite.config.ts
similarity index 100%
rename from packages/client/vite.config.ts
rename to sdks/typescript/client/vite.config.ts
diff --git a/packages/client/vitest.config.ts b/sdks/typescript/client/vitest.config.ts
similarity index 100%
rename from packages/client/vitest.config.ts
rename to sdks/typescript/client/vitest.config.ts
diff --git a/packages/server/README.md b/sdks/typescript/server/README.md
similarity index 76%
rename from packages/server/README.md
rename to sdks/typescript/server/README.md
index 83faaa1a..dae93193 100644
--- a/packages/server/README.md
+++ b/sdks/typescript/server/README.md
@@ -7,6 +7,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/@mcp-ui/server"><img src="https://img.shields.io/npm/v/@mcp-ui/server?label=server&color=green" alt="Server Version"></a>
   <a href="https://www.npmjs.com/package/@mcp-ui/client"><img src="https://img.shields.io/npm/v/@mcp-ui/client?label=client&color=blue" alt="Client Version"></a>
+  <a href="https://rubygems.org/gems/mcp_ui_server"><img src="https://img.shields.io/gem/v/mcp_ui_server?label=ruby-server&color=red" alt="Ruby Server SDK Version"></a>
   <a href="https://gitmcp.io/idosal/mcp-ui"><img src="https://img.shields.io/endpoint?url=https://gitmcp.io/badge/idosal/mcp-ui" alt="MCP Documentation"></a>
 </p>
 
@@ -34,10 +35,11 @@
 
 ## 💡 What's `mcp-ui`?
 
-`mcp-ui` is a TypeScript SDK comprising two packages:
+`mcp-ui` is a collection of SDKs comprising:
 
-* **`@mcp-ui/server`**: Utilities to generate UI resources (`UIResource`) on your MCP server.
-* **`@mcp-ui/client`**: UI components (e.g., `<UIResourceRenderer />`) to render the UI resources and handle their events.
+* **`@mcp-ui/server` (TypeScript)**: Utilities to generate UI resources (`UIResource`) on your MCP server.
+* **`@mcp-ui/client` (TypeScript)**: UI components (e.g., `<UIResourceRenderer />`) to render the UI resources and handle their events.
+* **`mcp_ui_server` (Ruby)**: Utilities to generate UI resources on your MCP server in a Ruby environment.
 
 Together, they let you define reusable UI snippets on the server side, seamlessly and securely render them in the client, and react to their actions in the MCP host environment.
 
@@ -71,7 +73,7 @@ interface UIResource {
 The UI Resource is rendered in the `<UIResourceRenderer />` component. It automatically detects the resource type and renders the appropriate component.
 
 It accepts the following props:
-- **`resource`**: The resource object from an MCP response. Should include `uri`, `mimeType`, and content (`text`, `blob`, or `content`)
+- **`resource`**: The resource object from an MCP Tool response. It must include `uri`, `mimeType`, and content (`text`, `blob`)
 - **`onUIAction`**: Optional callback for handling UI actions from the resource:
   ```typescript
   { type: 'tool', payload: { toolName: string, params: Record<string, unknown> }, messageId?: string } |
@@ -93,7 +95,7 @@ It accepts the following props:
 
 #### HTML (`text/html` and `text/uri-list`)
 
-Rendered using the `<HTMLResourceRenderer />` component, which displays content inside an `<iframe>`. This is suitable for self-contained HTML or embedding external apps.
+Rendered using the internal `<HTMLResourceRenderer />` component, which displays content inside an `<iframe>`. This is suitable for self-contained HTML or embedding external apps.
 
 *   **`mimeType`**:
     *   `text/html`: Renders inline HTML content.
@@ -101,16 +103,18 @@ Rendered using the `<HTMLResourceRenderer />` component, which displays content
 
 #### Remote DOM (`application/vnd.mcp-ui.remote-dom`)
 
-Rendered using the `<RemoteDOMResourceRenderer />` component, which uses Shopify's [`remote-dom`](https://github.com/Shopify/remote-dom). The server responds with a script that describes the UI and events. On the host, the script is securely rendered in a sandboxed iframe, and the UI changes are communicated to the host in JSON, where they're rendered using the host's component library. This is more flexible than iframes and allows for UIs that match the host's look-and-feel.
+Rendered using the internal `<RemoteDOMResourceRenderer />` component, which utilizes Shopify's [`remote-dom`](https://github.com/Shopify/remote-dom). The server responds with a script that describes the UI and events. On the host, the script is securely rendered in a sandboxed iframe, and the UI changes are communicated to the host in JSON, where they're rendered using the host's component library. This is more flexible than iframes and allows for UIs that match the host's look-and-feel.
 
 * **`mimeType`**: `application/vnd.mcp-ui.remote-dom+javascript; framework={react | webcomponents}`
 
 ### UI Action
 
-UI snippets must be able to interact with the agent. In `mcp-ui`, this is done by hooking into events sent from the UI snippet and reacting to them in the host. For example, an HTML may trigger a tool call when a button is clicked by sending an event which will be caught handled by the client.
+UI snippets must be able to interact with the agent. In `mcp-ui`, this is done by hooking into events sent from the UI snippet and reacting to them in the host (see `onUIAction` prop). For example, an HTML may trigger a tool call when a button is clicked by sending an event which will be caught handled by the client.
 
 ## 🏗️ Installation
 
+### TypeScript
+
 ```bash
 # using npm
 npm install @mcp-ui/server @mcp-ui/client
@@ -122,11 +126,19 @@ pnpm add @mcp-ui/server @mcp-ui/client
 yarn add @mcp-ui/server @mcp-ui/client
 ```
 
+### Ruby
+
+```bash
+gem install mcp_ui_server
+```
+
 ## 🎬 Quickstart
 
 You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to `mcp-ui`'s latest documentation! 
 
-1. **Server-side**: Build your resource blocks
+### TypeScript
+
+1. **Server-side**: Build your UI resources
 
    ```ts
    import { createUIResource } from '@mcp-ui/server';
@@ -185,7 +197,6 @@ You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to
            resource={mcpResource.resource}
            onUIAction={(result) => {
              console.log('Action:', result);
-             return { status: 'ok' };
            }}
          />
        );
@@ -194,7 +205,45 @@ You can use [GitMCP](https://gitmcp.io/idosal/mcp-ui) to give your IDE access to
    }
    ```
 
-3. **Enjoy** interactive MCP UI — no extra configuration required.
+### Ruby
+
+**Server-side**: Build your UI resources
+
+   ```ruby
+   require 'mcp_ui_server'
+
+   # Inline HTML
+   html_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://greeting/1',
+     content: { type: :raw_html, htmlString: '<p>Hello, from Ruby!</p>' },
+     encoding: :text
+   )
+
+   # External URL
+   external_url_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://greeting/2',
+     content: { type: :external_url, iframeUrl: 'https://example.com' },
+     encoding: :text
+   )
+
+   # remote-dom
+   remote_dom_resource = McpUiServer.create_ui_resource(
+     uri: 'ui://remote-component/action-button',
+     content: {
+       type: :remote_dom,
+       script: "
+        const button = document.createElement('ui-button');
+        button.setAttribute('label', 'Click me from Ruby!');
+        button.addEventListener('press', () => {
+          window.parent.postMessage({ type: 'tool', payload: { toolName: 'uiInteraction', params: { action: 'button-click', from: 'ruby-remote-dom' } } }, '*');
+        });
+        root.appendChild(button);
+        ",
+       framework: :react,
+     },
+     encoding: :text
+   )
+   ```
 
 ## 🌍 Examples
 
@@ -223,7 +272,7 @@ Host and user security is one of `mcp-ui`'s primary concerns. In all content typ
 - [X] Support Web Components
 - [X] Support Remote-DOM
 - [ ] Add component libraries (in progress)
-- [ ] Add SDKs for additional programming languages (in progress)
+- [ ] Add SDKs for additional programming languages (in progress; Ruby available)
 - [ ] Support additional frontend frameworks
 - [ ] Add declarative UI content type
 - [ ] Support generative UI?
diff --git a/packages/server/package.json b/sdks/typescript/server/package.json
similarity index 59%
rename from packages/server/package.json
rename to sdks/typescript/server/package.json
index 5c4f47a0..0974a723 100644
--- a/packages/server/package.json
+++ b/sdks/typescript/server/package.json
@@ -35,6 +35,33 @@
   "publishConfig": {
     "access": "public"
   },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      [
+        "@semantic-release/changelog",
+        {
+          "changelogFile": "CHANGELOG.md"
+        }
+      ],
+      "@semantic-release/npm",
+      "@semantic-release/github",
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "CHANGELOG.md",
+            "package.json"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]\\n\\n${nextRelease.notes}"
+        }
+      ]
+    ]
+  },
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "*"
diff --git a/packages/server/src/__tests__/index.test.ts b/sdks/typescript/server/src/__tests__/index.test.ts
similarity index 67%
rename from packages/server/src/__tests__/index.test.ts
rename to sdks/typescript/server/src/__tests__/index.test.ts
index dd83d5d6..5fa0a266 100644
--- a/packages/server/src/__tests__/index.test.ts
+++ b/sdks/typescript/server/src/__tests__/index.test.ts
@@ -1,4 +1,11 @@
-import { createUIResource } from '../index';
+import {
+  createUIResource,
+  uiActionResultToolCall,
+  uiActionResultPrompt,
+  uiActionResultLink,
+  uiActionResultIntent,
+  uiActionResultNotification,
+} from '../index';
 
 describe('@mcp-ui/server', () => {
   describe('createUIResource', () => {
@@ -152,5 +159,92 @@ describe('@mcp-ui/server', () => {
         "MCP-UI SDK: URI must start with 'ui://' when content.type is 'remoteDom'.",
       );
     });
+
+    it('should throw an error if htmlString is not a string for rawHtml', () => {
+      const options = {
+        uri: 'ui://test' as const,
+        content: { type: 'rawHtml' as const, htmlString: null },
+      };
+      // @ts-expect-error intentionally passing invalid type
+      expect(() => createUIResource(options)).toThrow(
+        "MCP-UI SDK: content.htmlString must be provided as a string when content.type is 'rawHtml'.",
+      );
+    });
+
+    it('should throw an error if iframeUrl is not a string for externalUrl', () => {
+      const options = {
+        uri: 'ui://test' as const,
+        content: { type: 'externalUrl' as const, iframeUrl: 123 },
+      };
+      // @ts-expect-error intentionally passing invalid type
+      expect(() => createUIResource(options)).toThrow(
+        "MCP-UI SDK: content.iframeUrl must be provided as a string when content.type is 'externalUrl'.",
+      );
+    });
+
+    it('should throw an error if script is not a string for remoteDom', () => {
+      const options = {
+        uri: 'ui://test' as const,
+        content: { type: 'remoteDom' as const, framework: 'react', script: { a: 1 } },
+      };
+      // @ts-expect-error intentionally passing invalid type
+      expect(() => createUIResource(options)).toThrow(
+        "MCP-UI SDK: content.script must be provided as a string when content.type is 'remoteDom'.",
+      );
+    });
+  });
+});
+
+describe('UI Action Result Creators', () => {
+  it('should create a tool call action result', () => {
+    const result = uiActionResultToolCall('testTool', { param1: 'value1' });
+    expect(result).toEqual({
+      type: 'tool',
+      payload: {
+        toolName: 'testTool',
+        params: { param1: 'value1' },
+      },
+    });
+  });
+
+  it('should create a prompt action result', () => {
+    const result = uiActionResultPrompt('Enter your name');
+    expect(result).toEqual({
+      type: 'prompt',
+      payload: {
+        prompt: 'Enter your name',
+      },
+    });
+  });
+
+  it('should create a link action result', () => {
+    const result = uiActionResultLink('https://example.com');
+    expect(result).toEqual({
+      type: 'link',
+      payload: {
+        url: 'https://example.com',
+      },
+    });
+  });
+
+  it('should create an intent action result', () => {
+    const result = uiActionResultIntent('doSomething', { data: 'abc' });
+    expect(result).toEqual({
+      type: 'intent',
+      payload: {
+        intent: 'doSomething',
+        params: { data: 'abc' },
+      },
+    });
+  });
+
+  it('should create a notification action result', () => {
+    const result = uiActionResultNotification('Success!');
+    expect(result).toEqual({
+      type: 'notify',
+      payload: {
+        message: 'Success!',
+      },
+    });
   });
 });
diff --git a/packages/server/src/index.ts b/sdks/typescript/server/src/index.ts
similarity index 100%
rename from packages/server/src/index.ts
rename to sdks/typescript/server/src/index.ts
diff --git a/packages/server/src/types.ts b/sdks/typescript/server/src/types.ts
similarity index 100%
rename from packages/server/src/types.ts
rename to sdks/typescript/server/src/types.ts
diff --git a/packages/server/tsconfig.json b/sdks/typescript/server/tsconfig.json
similarity index 77%
rename from packages/server/tsconfig.json
rename to sdks/typescript/server/tsconfig.json
index 62403114..464db628 100644
--- a/packages/server/tsconfig.json
+++ b/sdks/typescript/server/tsconfig.json
@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../../tsconfig.base.json",
   "compilerOptions": {
     "forceConsistentCasingInFileNames": true
   },
diff --git a/packages/server/vite.config.ts b/sdks/typescript/server/vite.config.ts
similarity index 100%
rename from packages/server/vite.config.ts
rename to sdks/typescript/server/vite.config.ts
diff --git a/packages/server/vitest.config.ts b/sdks/typescript/server/vitest.config.ts
similarity index 100%
rename from packages/server/vitest.config.ts
rename to sdks/typescript/server/vitest.config.ts
diff --git a/packages/shared/package.json b/sdks/typescript/shared/package.json
similarity index 100%
rename from packages/shared/package.json
rename to sdks/typescript/shared/package.json
diff --git a/packages/shared/src/index.ts b/sdks/typescript/shared/src/index.ts
similarity index 100%
rename from packages/shared/src/index.ts
rename to sdks/typescript/shared/src/index.ts
diff --git a/sdks/typescript/shared/tsconfig.json b/sdks/typescript/shared/tsconfig.json
new file mode 100644
index 00000000..42a0fdd7
--- /dev/null
+++ b/sdks/typescript/shared/tsconfig.json
@@ -0,0 +1,11 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": "src",
+    "paths": {
+      "@/*": ["./src/"]
+    }
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "src/__tests__"]
+}
diff --git a/packages/shared/vite.config.ts b/sdks/typescript/shared/vite.config.ts
similarity index 100%
rename from packages/shared/vite.config.ts
rename to sdks/typescript/shared/vite.config.ts
diff --git a/vitest.config.ts b/vitest.config.ts
index d35b56ac..13b8c1c0 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -10,13 +10,13 @@ export default defineConfig({
       reporter: ['text', 'json', 'html'],
       reportsDirectory: './coverage',
       all: true, // Cover all files, not just tested ones
-      include: ['packages/*/src/**/*.{ts,tsx}'],
+      include: ['sdks/typescript/*/src/**/*.{ts,tsx}'],
       exclude: [
-        'packages/*/src/index.{ts,tsx}',
-        'packages/**/*.d.ts',
-        'packages/**/__tests__/**',
-        'packages/**/dist/**',
-        'apps/docs/**',
+        'sdks/typescript/*/src/index.{ts,tsx}',
+        'sdks/typescript/*/**/*.d.ts',
+        'sdks/typescript/*/**/__tests__/**',
+        'sdks/typescript/*/**/dist/**',
+        'docs/src/**',
       ],
     },
   },
diff --git a/workflows/ci.yml b/workflows/ci.yml
deleted file mode 100644
index 5f04eb6e..00000000
--- a/workflows/ci.yml
+++ /dev/null
@@ -1,59 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - main
-  release:
-    types: [published]
-
-jobs:
-  build_and_test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-          cache: 'pnpm'
-          cache-dependency-path: '**/package-lock.json'
-
-      - name: Install dependencies
-        run: pnpm install --workspaces --frozen-lockfile
-
-      - name: Lint
-        run: pnpm run lint
-
-      - name: Test
-        run: pnpm run test
-
-      - name: Build
-        run: pnpm run build
-
-  publish:
-    needs: build_and_test
-    if: github.event_name == 'release' && github.event.action == 'published'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'pnpm'
-          cache-dependency-path: '**/package-lock.json'
-
-      - name: Install dependencies
-        run: pnpm install --workspaces --frozen-lockfile
-
-      - name: Build
-        run: pnpm run build
-
-      - name: Publish to NPM
-        run: pnpm run publish-packages
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}