Skip to content
supercarto
Esc
↑↓navigate↵open⌘Jpreview
On this page

Quick start

Install supercarto, return your first maplet, and wire it into an agent — Node, Python, Claude Desktop, or the hosted endpoint.

supercarto needs Node.js 20+ (server) and nothing else: zero runtime npm dependencies, no database, no API key. A coordinate and a token budget are the whole interface.

npm install supercarto
pnpm add supercarto
yarn add supercarto
bun add supercarto
nub add supercarto
aube add supercarto
npm install pip install supercarto
pnpm add pip install supercarto
yarn add pip install supercarto
bun add pip install supercarto
nub add pip install supercarto
aube add pip install supercarto

The Python client speaks JSON-RPC to the Node server over stdio rather than importing an SDK, so it carries zero runtime dependencies of its own.

npx supercarto mcp
pnpm dlx supercarto mcp
yarn dlx supercarto mcp
bunx supercarto mcp
nubx supercarto mcp
aube dlx supercarto mcp

Download the latest release bundle and open the supercarto-X.Y.Z.mcpb file with Claude Desktop — one click, and the tools install with optional configuration (weather key, GTFS feed path). The bundle is 384 KB.

Your first maplet

import { SuperCarto } from 'supercarto';

const carto = new SuperCarto();

const result = await carto.maplet({
  lat: 35.6833,
  lon: 139.7620,
  radiusM: 400,
  budget: 1500,
});

console.log(result.yaml);

result.yaml is a standard-YAML topological graph: named nodes, edges with distances in metres and compass directions, an omitted: record of everything cut, and the tools the agent can call next. The same answer, from the CLI:

supercarto fetch --lat 35.6833 --lon 139.762 --radiusM 400 --budget 1500 --metrics

Turn it into an MCP server

The one process answers MCP over stdio:

npx supercarto mcp

Standard mcpServers configuration for any MCP client:

{
  "mcpServers": {
    "supercarto": { "command": "npx", "args": ["supercarto", "mcp"] }
  }
}

Like it as a bundle instead?

One-click Claude Desktop install, install-time keys, and the honest “tools_generated” manifest are covered in MCP and Claude Desktop.

Nine tools advertise out of the box (get_maplet, localize, route, search_places, expand_feature, get_terrain, get_weather, get_air, get_daylight). Two more appear only when their configuration exists — see the tools.

Deployment surfaces

Last updated on

Was this page helpful?