{"_id":"@bossforce.ai/mcp-figma","name":"@bossforce.ai/mcp-figma","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bossforce.ai/mcp-figma","version":"0.1.0","type":"module","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/design-creative/figma"},"publishConfig":{"access":"public"},"bin":{"bossforce-mcp-figma":"dist/bin.js"},"dependencies":{"zod":"^4.4.3","@bossforce.ai/mcp-core":"0.3.0"},"devDependencies":{"@bossforce.ai/mcp-testkit":"0.0.0"},"scripts":{"build":"tsc -p tsconfig.json","test":"node --test \"dist/*.test.js\""},"_id":"@bossforce.ai/mcp-figma@0.1.0","description":"MCP server for the Figma **REST API**, read-only, using a personal access token. A good fit for inspecting design files and exporting assets. It does not modify files.","bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","_integrity":"sha512-uTSTujC1KbMZhriFNedfH3pUYj+10h0ii1tCz6Tt1x5zmXr6Fl1gmlvwzyMvLqZBynNXiyBXfsFl7P2IpY4Pjw==","_resolved":"C:\\Users\\user\\AppData\\Local\\Temp\\c8309d648cb9d1f7fb85638f388ffb08\\bossforce.ai-mcp-figma-0.1.0.tgz","_from":"file:bossforce.ai-mcp-figma-0.1.0.tgz","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-uTSTujC1KbMZhriFNedfH3pUYj+10h0ii1tCz6Tt1x5zmXr6Fl1gmlvwzyMvLqZBynNXiyBXfsFl7P2IpY4Pjw==","shasum":"ef32fb9607cbd0dacafc1c61693ea02035bc210d","tarball":"https://registry.npmjs.org/@bossforce.ai/mcp-figma/-/mcp-figma-0.1.0.tgz","fileCount":26,"unpackedSize":21528,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCHQoxO5EIuoyxaAF2oukd/ItzZ8VcvQ50ccjzp5N16XgIgOXA9bxXXElfiLGANGD1vEg8lKwgC0FH36fJnU0B/N2U="}]},"_npmUser":{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"},"directories":{},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-figma_0.1.0_1781237959115_0.1175156231639074"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-12T04:19:19.007Z","0.1.0":"2026-06-12T04:19:19.241Z","modified":"2026-06-12T04:19:19.417Z"},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"description":"MCP server for the Figma **REST API**, read-only, using a personal access token. A good fit for inspecting design files and exporting assets. It does not modify files.","homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/design-creative/figma"},"bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"readme":"# @bossforce.ai/mcp-figma\n\nMCP server for the Figma **REST API**, read-only, using a personal access token.\nA good fit for inspecting design files and exporting assets. It does not modify\nfiles.\n\n## Credentials\n\n| Env           | How to obtain                                                                                                                                         |\n| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `FIGMA_TOKEN` | In Figma, go to Settings → Security → Personal access tokens, generate a token with the `file_content:read` and `file_comments:read` scopes, copy it. |\n\nThe token is sent in the `X-Figma-Token` header (not `Authorization: Bearer`). It\nis read lazily, so the server boots and answers `tools/list` without it; calls\nfail with an `auth` error until it is set. A bad or expired token returns HTTP\n403 (mapped to `auth`).\n\n## Tools\n\n| Tool             | Arguments                                            | Returns                               |\n| ---------------- | ---------------------------------------------------- | ------------------------------------- |\n| `get_file`       | `file_key`, `version?`, `depth?`, `geometry?`        | full file document (`document`, …)    |\n| `get_file_nodes` | `file_key`, `ids`, `version?`, `depth?`, `geometry?` | `{ nodes }` keyed by node id          |\n| `get_images`     | `file_key`, `ids`, `format?`, `scale?`, `version?`   | `{ images }` of temporary render urls |\n| `get_comments`   | `file_key`, `as_md?`                                 | `{ comments }`                        |\n\nResponses are Figma's native JSON payloads, returned as `structuredContent`.\n\n### Keys and node ids\n\n`file_key` is the segment in a file url: `figma.com/design/{file_key}/...` (older\n`/file/{file_key}/...` urls also work). `ids` is a comma-separated list of node\nids (e.g. `1:2,1:5`), visible in the url fragment `node-id=`. The urls returned by\n`get_images` are temporary and expire.\n\n## Develop\n\n```bash\npnpm --filter @bossforce.ai/mcp-figma build\npnpm --filter @bossforce.ai/mcp-figma test\n```\n\nRegenerate the tools/list snapshot after an intentional signature change:\n\n```bash\nUPDATE_SNAPSHOTS=1 pnpm --filter @bossforce.ai/mcp-figma test\n```\n","readmeFilename":"README.md","_rev":"1-fea2de7c7a13fe5794fa7e71e7d082ed"}