# Blender MCP JSON Protocol Format: Complete Guide to Commands and Responses

> Master the Blender MCP JSON protocol. Learn request and response formats for seamless command execution and data retrieval.  Explore TCP socket communication for your projects.

- Repository: [ahujasid/blender-mcp](https://github.com/ahujasid/blender-mcp)
- Tags: api-reference
- Published: 2026-04-13

---

**Blender MCP uses a lightweight JSON protocol where clients send `{"type": "command_name", "params": {...}}` requests and receive `{"status": "success"|"error", "result": {...}}` or `{"status": "error", "message": "..."}` responses over TCP sockets.**

The JSON protocol format used by Blender MCP enables seamless communication between the Python MCP server running inside the Blender add-on and external clients such as the `BlenderConnection` class. This bidirectional message exchange allows external tools to query scene information, manipulate objects