figura-mcp 0.3.1 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
A [Model Context Protocol](https://modelcontextprotocol.io) server that exposes
|
|
4
4
|
the **Figura** visualization SaaS to MCP clients (Claude Code, Claude Desktop,
|
|
5
|
-
etc.). It speaks to the Figura `/
|
|
5
|
+
etc.). It speaks to the Figura `/v1` HTTP API with a Bearer `fig_` token over
|
|
6
6
|
stdio.
|
|
7
7
|
|
|
8
8
|
## Token
|
|
@@ -13,7 +13,7 @@ The server reads the token from, in order:
|
|
|
13
13
|
2. `~/.figura/config.json` (`{ "token": "fig_..." }`) — the same file the
|
|
14
14
|
`figura-cli` `figura login` command writes.
|
|
15
15
|
|
|
16
|
-
Base URL defaults to `https://figura.so`; override with `FIGURA_API_URL`.
|
|
16
|
+
Base URL defaults to `https://api.figura.so`; override with `FIGURA_API_URL`.
|
|
17
17
|
All requests carry the `X-Figura-Source: mcp` header.
|
|
18
18
|
|
|
19
19
|
## Add to Claude Code
|
|
@@ -30,19 +30,30 @@ the server will fall back to `~/.figura/config.json`.
|
|
|
30
30
|
|
|
31
31
|
## Tools
|
|
32
32
|
|
|
33
|
-
| Tool
|
|
34
|
-
|
|
|
35
|
-
| `figura_whoami`
|
|
36
|
-
| `
|
|
37
|
-
| `
|
|
38
|
-
| `
|
|
39
|
-
| `
|
|
33
|
+
| Tool | Input |
|
|
34
|
+
| ---------------------- | ------------------------------------------------------------------------------------------------------------- |
|
|
35
|
+
| `figura_whoami` | `{}` |
|
|
36
|
+
| `figura_set_brand` | `name`, optional `description`, `tokensBlock` |
|
|
37
|
+
| `figura_create_fig` | `html`, optional `title`, `description`, `area`, `tags[]`, `orientation`, `mode`, `model`, `issue`, `publish` |
|
|
38
|
+
| `figura_generate_fig` | `brief`, optional `title`, `area`, `orientation`, `mode`, `fidelity`, `publish` |
|
|
39
|
+
| `figura_revise_fig` | `id`, `html`, optional `title`, `description`, … |
|
|
40
|
+
| `figura_list_revisions`| `id` |
|
|
41
|
+
| `figura_update_fig` | `id`, optional `title`, `description`, `area`, `tags[]`, `status` |
|
|
42
|
+
| `figura_publish_fig` | `id`, optional `unpublish` |
|
|
43
|
+
| `figura_delete_fig` | `id`, optional `hard` |
|
|
44
|
+
| `figura_list_figs` | optional `area`, `tag`, `limit`, `cursor` |
|
|
45
|
+
| `figura_get_fig` | `id` |
|
|
46
|
+
| `figura_comment` | `fig_id`, `body` |
|
|
47
|
+
| `figura_request_feedback` | `id`, `from`, optional `note` |
|
|
48
|
+
| `figura_list_sources` | `{}` |
|
|
49
|
+
| `figura_sync_source` | optional `id` |
|
|
40
50
|
|
|
41
51
|
Enum values:
|
|
42
52
|
|
|
43
|
-
- `area`:
|
|
53
|
+
- `area`: free text (a product-area hint, e.g. `feed`, `settings`, `other`) — not a fixed enum.
|
|
44
54
|
- `orientation`: `portrait | landscape | both`
|
|
45
55
|
- `mode`: `single | compare | variations`
|
|
56
|
+
- `fidelity` (`figura_generate_fig`): `fast | high`
|
|
46
57
|
|
|
47
58
|
Each tool returns its JSON result as a text content block; failures return
|
|
48
59
|
`isError: true` with the server's error message.
|