Get metadata
figma_local_get_metadataReturns XML metadata for a Figma node or page—IDs, layer types, names, positions, and sizes—for a structural overview before requesting fuller design context.
Instructions
IMPORTANT: Always prefer figma_local_get_design_context. Get metadata for a node or page in XML format: node IDs, layer types, names, positions and sizes only. Useful for an overview of the structure; call figma_local_get_design_context on the node IDs it contains. The nodeId can also be a page id (e.g. 0:1). When nodeId is omitted, returns the top-level pages of the document instead. If the URL includes node-id, pass it as nodeId; otherwise omit nodeId. For branch URLs use the branchKey as the fileKey.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fileKey": "<fileKey>"
},
"name": "figma_local_get_metadata"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nodeId | No | The ID of the node in the Figma document, eg. "123:456" or "123-456". Extract it from the URL's node-id query parameter. Do not pass an empty or guessed nodeId. | |
| fileKey | Yes | The key of the Figma file to use. If a URL is provided, extract the file key from it: for https://figma.com/design/:fileKey/:fileName?node-id=1-2 the fileKey is `:fileKey`. For https://figma.com/design/:fileKey/branch/:branchKey/:fileName use the branchKey. A full URL is also accepted. | |
| clientLanguages | No | A comma separated list of programming languages used by the client in the current context, e.g. `javascript`, `html,css,typescript`. If you do not know, list `unknown`. | |
| clientFrameworks | No | A comma separated list of frameworks used by the client in the current context, e.g. `react`, `vue`, `django`. If you do not know, list `unknown`. |