Overview

The DEON MCP server is a hosted Model Context Protocol endpoint that lets LLMs and agents work with DEON projects in natural language — placing items on a canvas, connecting and styling them, uploading and fetching images, and retrieving project knowledge (RAG).

Every tool call is translated into the same requests the DEON web client makes, so anything an agent creates or edits shows up live in the project for all collaborators.

At a Glance

Transport	Streamable HTTP (stateless)
Endpoint	POST https://api.deon.cloud/mcp
Authentication	DEON API token (deon_tk_…) in the Authorization header
Capabilities	12 tools (no resources or prompts)
Health check	GET https://api.deon.cloud/health

See Connecting for client configuration examples.

Data Model

A DEON project is a map of items on an infinite 2D canvas:

• Coordinates are world units. position is the item's top-left corner as { x, y }.
• Size is the bounding box as { width, height }.
• Rotation is angle in degrees (0–360).
• Colors are CSS color strings, e.g. "#3B82F6" or "rgba(0,0,0,0.5)" — never objects.

Item types match the REST Project Item API: label, sticky-note, shape, connector, image, web, svg, and document. The get_data_model tool returns this reference at runtime so an agent can look it up mid-conversation.

Available Tools

Tool	Description
list_projects	List the projects the caller can access.
get_project	Fetch a project's metadata and a flattened list of its canvas items.
create_item	Create a text item — a label or a sticky note.
create_shape	Place a geometric shape (rectangle, ellipse, arrow, star, …) on the canvas.
connect_items	Draw a connector (line/arrow) between two existing items.
style_item	Change an item's colors, stroke, or font size — mapped per item type.
update_item_property	Set a single property of an item by its friendly name.
delete_item	Remove an item from a project.
upload_image	Upload an image (base64 or URL) and place it on the canvas.
get_image_data	Download the bytes of an image item or stored file.
retrieve_knowledge	Semantic search (RAG) over a project's indexed knowledge.
get_data_model	Return the DEON data-model reference (item types, fields, shape names).

Typical Workflow

1. list_projects — discover project ids.
2. get_project — read the canvas; item ids from the result feed the editing tools.
3. create_item / create_shape / upload_image — add content.
4. connect_items, style_item, update_item_property — connect, style, and refine.
5. retrieve_knowledge — ground answers in the project's actual content.

note

https://api.deon.cloud is a placeholder for your deployment's public hostname throughout these docs.