mcp-compress-router 1.3.0 → 1.3.1

package/README.md

@@ -29,6 +29,7 @@
     - [OAuth](#oauth)
         - [Redirect URL](#redirect-url)
         - [GitHub MCP (special case)](#github-mcp-special-case)
+        - [Figma MCP (special case)](#figma-mcp-special-case)
     - [Custom Headers](#custom-headers)
     - [Secrets and Variable Expansion](#secrets-and-variable-expansion)
 - [Connecting Coding Agents](#connecting-coding-agents)
@@ -429,6 +430,89 @@ organizations you want the MCP to access.
 > login will succeed, and its client secret is generated under *General*
 > → *Generate a new client secret*.
 
+#### Figma MCP (special case)
+
+The official Figma MCP server at `https://mcp.figma.com/mcp` does **not**
+support Dynamic Client Registration through the standard MCP flow.
+Instead you register an OAuth client via Figma's REST API using a
+Personal Access Token, then pass the resulting credentials through the
+`oauth` block. Figma also requires the redirect URI to use a **fixed
+port** — the port you register is reused on every `login`, so you must
+pin it with `oauth.callbackPort`.
+
+1. **Create a Figma Personal Access Token.**
+   Follow
+   <https://developers.figma.com/docs/rest-api/personal-access-tokens/>
+   to generate a PAT and export it as `FIGMA_PERSONAL_ACCESS_TOKEN`. It
+   is only used to register the MCP client in the next step.
+
+2. **Register the MCP client via Figma's API.**
+   The redirect URI must use `127.0.0.1` on a fixed port — **the port
+   matters**, it is reused on every `login`. This example uses `19876`:
+
+   ```bash
+   curl -X POST https://api.figma.com/v1/oauth/mcp/register \
+     -H "Content-Type: application/json" \
+     -H "X-Figma-Token: $FIGMA_PERSONAL_ACCESS_TOKEN" \
+     -d '{
+       "client_name": "Claude Code (figma)",
+       "redirect_uris": ["http://127.0.0.1:19876/mcp-compress-router/oauth-callback"],
+       "grant_types": ["authorization_code", "refresh_token"],
+       "response_types": ["code"],
+       "token_endpoint_auth_method": "none"
+     }'
+   ```
+
+   Save the `client_id` and `client_secret` from the response (also note
+   the `scope` is `mcp:connect`):
+
+   ```json
+   {
+     "client_id": "CLIENTID",
+     "client_secret": "CLIENTSECRET",
+     "client_name": "Claude Code (figma)",
+     "redirect_uris": ["http://127.0.0.1:19876/mcp-compress-router/oauth-callback"],
+     "token_endpoint_auth_method": "none",
+     "scope": "mcp:connect"
+   }
+   ```
+
+3. **Add the Figma MCP server by URL.**
+
+   ```bash
+   npx mcp-compress-router add --transport http figma https://mcp.figma.com/mcp
+   ```
+
+4. **Set `oauth` credentials in `mcp.json`.**
+   Put the client ID and secret from step 2 in the server entry, using
+   the `mcp:connect` scope and the **same fixed port** you registered as
+   `callbackPort`:
+
+   ```jsonc
+   "figma": {
+     "type": "http",
+     "url": "https://mcp.figma.com/mcp",
+     "oauth": {
+       "clientId": "${FIGMA_CLIENT_ID}",
+       "clientSecret": "${FIGMA_CLIENT_SECRET}",
+       "scope": "mcp:connect",
+       "callbackPort": 19876
+     }
+   }
+   ```
+
+   Put the actual values in your `.env` file (see
+   [Secrets and Variable Expansion](#secrets-and-variable-expansion)).
+
+5. **Run the login command.**
+
+   ```bash
+   npx mcp-compress-router login figma
+   ```
+
+   Your browser opens to authorize. After you approve, tokens are stored
+   in `credentials.json` and the router can call Figma MCP tools.
+
 Other OAuth commands:
 
 ```bash
@@ -512,7 +596,7 @@ Add the router to your `opencode.json` under `mcp`:
 {
   "$schema": "https://opencode.ai/config.json",
   "mcp": {
-    "compress-router": {
+    "mcp-compress-router": {
       "type": "local",
       "command": ["npx", "-y", "mcp-compress-router"],
       "enabled": true
@@ -533,7 +617,7 @@ your user-level config (applies to every project):
 ```json
 {
   "mcpServers": {
-    "compress-router": {
+    "mcp-compress-router": {
       "command": "npx",
       "args": ["-y", "mcp-compress-router"]
     }
@@ -543,14 +627,14 @@ your user-level config (applies to every project):
 
 ### Codex
 
-Add a `[mcp_servers.compress-router]` table to your Codex config (note
+Add a `[mcp_servers.mcp-compress-router]` table to your Codex config (note
 the snake_case key). The config path is `~/.codex/config.toml` on
 macOS/Linux, or `%USERPROFILE%\.codex\config.toml` on Windows; you can
 also scope it to a single project via `.codex/config.toml` in trusted
 projects.
 
 ```toml
-[mcp_servers.compress-router]
+[mcp_servers.mcp-compress-router]
 command = "npx"
 args = ["-y", "mcp-compress-router"]
 enabled = true
@@ -568,7 +652,7 @@ merged, with project-level taking precedence.
 ```json
 {
   "servers": {
-    "compress-router": {
+    "mcp-compress-router": {
       "command": "npx",
       "args": ["-y", "mcp-compress-router"]
     }

package/build/cli/router-runner.js

@@ -38,7 +38,9 @@ async function startRouterServer(catalog, clients, logger) {
     const invokeFn = (server, tool, args) => invokeDownstreamTool(clients, server, tool, args, logger);
     router.registerTool('invoke_tool', {
         title: 'Invoke Tool',
-        description: 'Invoke a specific tool on a connected MCP server. First use get_tool_schema to retrieve the required parameters.',
+        description: 'Invoke a specific tool on a connected MCP server. ' +
+            'You MUST first use get_tool_schema to retrieve the required parameters ' +
+            'for this tool before calling invoke_tool.',
         inputSchema: InvokeToolInputSchema,
     }, createInvokeToolHandler(catalog, invokeFn, logger));
     const transport = new StdioServerTransport();

package/build/tools/get-tool-schema.js

@@ -55,5 +55,7 @@ export function createGetToolSchemaHandler(catalog, logger) {
  */
 export function buildGetToolSchemaDescription(catalog) {
     const compact = renderCompactCatalog(catalog.servers);
-    return 'Get the JSON schema for one or more tools from a connected MCP server.\n\n' + compact;
+    return ('Get the JSON schema for one or more tools from a connected MCP server. ' +
+        'You MUST call this for a tool before you can invoke it with invoke_tool.\n\n' +
+        compact);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-compress-router",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Compress all connected MCP servers into a single router MCP to save tokens",
   "license": "MIT",
   "type": "module",