Figma MCP Server
by moonray
{
"openapi": "3.0.0",
"info": {
"title": "Figma MCP Server API",
"description": "API for analyzing Figma file structures",
"version": "1.0.0"
},
"servers": [
{
"url": "http://localhost:3000",
"description": "Local development server"
}
],
"paths": {
"/analyze": {
"post": {
"summary": "Analyze a Figma file",
"description": "Analyze a Figma file structure to extract node hierarchy",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["figmaUrl"],
"properties": {
"figmaUrl": {
"type": "string",
"description": "URL of the Figma file to analyze"
},
"depth": {
"type": "integer",
"description": "Optional depth parameter to limit the node tree depth"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"fileId": {
"type": "string",
"description": "Figma file ID"
},
"nodeId": {
"type": "string",
"description": "Figma node ID"
},
"tree": {
"type": "object",
"description": "Hierarchical node tree data"
}
}
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Error message"
}
}
}
}
}
},
"500": {
"description": "Server error",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Error message"
}
}
}
}
}
}
}
}
},
"/health": {
"get": {
"summary": "Health check",
"description": "Returns the health status of the API",
"responses": {
"200": {
"description": "Server is healthy",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Health status"
}
}
}
}
}
}
}
}
}
}
}