NeuronForm 3D map models

NeuronForm MCP server

NeuronForm turns OpenStreetMap data into print-ready, multi-colour 3D map models. Its public MCP server lets AI assistants such as Claude or ChatGPT design these models in a chat: find a place, create and change a design, show it as an image and, where the chat supports it, as a rotatable 3D view, and hand the user a link that opens exactly that design in the NeuronForm configurator.

This repository holds the documentation of the server, example briefs with the prompts that produce them, and the server.json for the MCP registry. It holds no code of the NeuronForm service.

German version: Deutsch. Website: neuronform.com/agents/en.

MCP address

https://neuronform.com/mcp

Agents never export print files and never buy. Exports and purchases happen only in the configurator, with the user's own NeuronForm account.

Setup

Claude (claude.ai, desktop, and mobile apps)

Custom connectors are available on every Claude plan; the free plan allows one.

1. Open “Customize” › “Connectors”.
2. Choose “+ Add” and then “Add custom connector”.
3. Enter the name NeuronForm and the MCP address, and select “Continue”.
4. Review the detected authentication settings and select “Continue”.
5. Under “Authentication”, choose “No sign in”.
6. Select “Add”.

In a chat, switch the connector on under “+” › “Connectors”. In Team and Enterprise organizations an owner adds the connector under “Organization settings” › “Connectors” with “Add” › “Custom” › “Web”, and members connect it under “Customize” › “Connectors” with “Connect”. Source: Anthropic help article on custom connectors.

ChatGPT

Whether you can add your own MCP servers depends on the ChatGPT plan and, in a workspace, on its permissions and security settings.

1. Open ChatGPT Plugins in ChatGPT on the web.
2. Choose the plus button and then “Add custom MCP server”.
3. Enter the name NeuronForm and, optionally, a short description.
4. Under “Connection”, choose the public endpoint and enter the MCP address.
5. Choose “No authentication”, review the risk warning, and select “I understand and want to continue”.
6. Select “Create as a plugin”, review the tools the server lists, and install the plugin.

In a new conversation, type @ and choose NeuronForm. OpenAI changes these labels from time to time; its developer documentation holds the current steps.

Claude Code

claude mcp add --transport http neuronform https://neuronform.com/mcp

With --scope project the entry goes into the .mcp.json of the project.

Cursor

.cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project:

{

"mcpServers": { "neuronform": { "url": "https://neuronform.com/mcp" } } }

VS Code

Run “MCP: Add Server” from the Command Palette, choose “HTTP (HTTP or Server-Sent Events)”, enter the MCP address and the server ID neuronform, and choose a destination:

• “Global” › “Copilot Global” writes ~/.copilot/mcp-config.json, or $COPILOT_HOME/mcp-config.json when COPILOT_HOME is set, for every workspace.
• .mcp.json at the root of the workspace shares the server with a team; the guided flow offers it with the experimental setting chat.mcp.workspaceRootConfig.enabled.
• .vscode/mcp.json in the workspace, which the guided flow labels deprecated.

The entry in .vscode/mcp.json:

{

"servers": { "neuronform": { "type": "http", "url": "https://neuronform.com/mcp" } } }

The portable files ~/.copilot/mcp-config.json and .mcp.json list the same entry under mcpServers instead of servers. Microsoft describes the destinations in its documentation of MCP servers in VS Code.

Other clients

Every client that connects to remote MCP servers over Streamable HTTP needs only the MCP address.

Tools

Every tool takes the optional argument lang (de or en, default en). It sets the language of the summaries, the notices, and the lead sentences and hints of error messages; the guide texts and the detail texts of the design validation are English. A successful call returns a text block with a short summary followed by the JSON result, and the same result as structuredContent; render_design returns the JPEG image before the text block, and the text block of get_design_guide holds the guide text. A failed call returns isError: true with an actionable message and, in structuredContent, the message and the list errors with one entry per refused field (field, message, hint); an unknown tool name is a JSON-RPC error. The design argument is the complete design JSON; its schema is the resource neuronform://schema/design.

Guide topics of get_design_guide: overview, footprint, tiles, colors_and_layers, terrain, frame, hanging, paths, texts_and_shapes, inserts, edge_labels, element_takeover, details, focus_scaling, custom_houses, limits.

Besides the fields of the brief, a design takes every field of the configurator through edit_design: among them texts and shapes sized in millimetres of the print or in metres on the map (topic texts_and_shapes), the generic details (roofs, windows, doors, and trees, with a facade style and a detail level, up to a map width of 3 km; topic details), focus scaling that magnifies one place and shrinks its surroundings toward the edge (topic focus_scaling), and up to five custom houses on free ground or in place of a building of the map (topic custom_houses).

A compass direction of edit_tiles selects the edge whose outward normal lies within 22.5° of it, so the directions follow the shape and the rotation: a hexagon without rotation offers ne, e, se, sw, w, and nw. validate_design and render_design list the free edges of every tile.

Brief

The brief of create_design and the changes of edit_design; in a brief only the place, or lat and lon, is required, and in changes an absent field keeps the design.

| lang | Language of the notices, de or en; when absent, the lang argument of the ca