Skip to main content
Glama

Declare map structure

mmap_declare

Declare or grow a layered map by setting its title, diagram kind, layers, lanes, groups, nodes, and downward edges in a single all-or-nothing batch.

Instructions

Grow the Mellos map: set the title and diagram kind, add layer bands, lanes and groups (labeled subsystems within a band — the zoomed-out view renders groups, so declare them for any map beyond a handful of nodes), add nodes, add dependency edges. Declare the whole ghost design up front, then grow it as understanding deepens. Edges must point strictly downward (a node may only use nodes on lower layers); the batch is all-or-nothing.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
kindNodiagram kind. dev (default) = the live progress ledger with status skins. The rest are documentation diagrams rendered neutrally: architecture (layered components; also fits call graphs and module dependencies), dataflow (source→transform→sink, stages as layers), behavior-tree (root on top, leaves at the bottom; also fits mind maps and WBS), sequence (classic call/return: rank = time step with rank 0 = EARLIEST, drawn top-down; declare lanes as participants and make every call AND every return its own event node in the acting participant's lane, edges labeled with the message). State machines are unsupported: cycles cannot enter a Mellos map.
pageNopage (parallel map) this call targets; omit for the default page. One effort = one page: start a NEW effort on its own page named after the effort, so concurrent sessions never write over each other and the pane can switch between pages.
edgesNo
lanesNovertical columns crossing all bands; declaration order = left-to-right
nodesNo
titleNomap title, e.g. the feature being built
groupsNo
layersNo
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It discloses critical behaviors: 'Edges must point strictly downward' and 'the batch is all-or-nothing.' It also hints at group rendering in the zoomed-out view. Missing details about idempotency or page behavior, but core constraints are covered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences: the first enumerates actions, the second gives workflow guidance, and the third states constraints. This is tight, front-loaded, and free of fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 8 parameters and no annotations, the description provides a solid overview of the core structure. However, it omits optional parameters like page, status, submap, and detail, though the rich schema descriptions cover those. The all-or-nothing caveat adds valuable operational context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description maps high-level parameters (title, kind, layers, lanes, groups, nodes, edges) but does not detail individual parameter semantics beyond what the schema already provides. With schema coverage at 50%, it partially compensates by grouping concepts, but leaves out optional fields like page, status, submap, and detail.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Grow the Mellos map' with specific actions (set title/kind, add layers, lanes, groups, nodes, edges). This differentiates it from siblings mmap_update/remove/view by focusing on declaring the entire structure.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear context: 'Declare the whole ghost design up front, then grow it as understanding deepens.' This implies initial creation and iterative growth, but it does not explicitly contrast with mmap_update, leaving some ambiguity about when to use one over the other.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GuangminJu/mellos-mapping'

If you have feedback or need assistance with the MCP directory API, please join our Discord server