MCP Server

Let AI agents read and write your Boxli profile via the Model Context Protocol.

What is it?

The Boxli MCP server exposes your profile as a set of tools that any MCP-compatible AI client (Claude Desktop, Cursor, Continue, etc.) can call. This means an AI agent can:

  • Read your current tiles and profile metadata
  • Add, update, or delete tiles on your behalf
  • Generate a full layout and publish it in one shot
  • Act as a live profile editor inside your AI chat

✓ MCP server access is available on the Free plan.

Claude Desktop setup

Add the following to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{ "mcpServers": { "boxli": { "command": "node", "args": ["/path/to/boxli-me/mcp-server/dist/index.js"], "env": { "BOXLI_API_KEY": "YOUR_API_KEY", "BOXLI_BASE_URL": "https://boxli.me" } } } }

Replace YOUR_API_KEY with your Boxli API key and adjust the path to wherever you cloned the repo.

Building the MCP server

cd mcp-server npm install npm run build

Available tools

get_profile

Get the full profile and all tiles for a given slug.

add_tile

Add a single tile to a profile. Respects the plan tile limit.

update_tile

Update a tile's content, position, or theme by tile ID.

delete_tile

Remove a tile by ID.

replace_tiles

Replace all tiles on a profile with a new set.

publish_profile

Publish the current state of a profile (saves a PageSnapshot).

Example prompt

“Look at my Boxli profile at slug ‘alex’, add a new social tile for my Bluesky handle @alex.bsky.social, then publish the profile.”
Self-Hosting →