Agent tooling · Model Context Protocol

MCP & CLI for AkmanOS components

Connect Cursor via hosted MCP on akmanos.com, or use the CLI — no repo clone. Component-only markdown, not the full site.

What you get

  • Search and list the open component library.
  • Fetch markdown for one component — scoped CSS, not whole-site globals.
  • Host collision rules so labels survive in foreign apps.

Tools

  • search_components

    Search components by name, id, or category.

  • list_components

    List the open component library.

  • get_component

    Metadata and preview URL for one component.

  • get_component_markdown

    Pixel-identical markdown for ONE component (not the full site).

  • get_host_rules

    Host collision rules for foreign design systems.

Resources

  • akmanos://catalogComponent catalog JSON (components only).

CLI

Runs on https://akmanos.com/api/mcp — add the URL in Cursor MCP settings. No local install.

  • akmanos list

    List components (--category, --json).

  • akmanos search <query>

    Search the library.

  • akmanos info <id>

    Component metadata + preview URL.

  • akmanos markdown <id>

    Component-only markdown (--out file.md).

  • akmanos rules

    Host collision rules for foreign apps.

npm run akmanos -- search funnel chart
npm run akmanos -- markdown funnel-chart --out funnel-chart.md
npm run akmanos -- list --category charts

Setup in Cursor (MCP)

  1. 1.Open Cursor Settings → MCP (or edit .cursor/mcp.json).
  2. 2.Add the akmanos server with url pointing to akmanos.com/api/mcp — no repo clone.
  3. 3.Reload Cursor. Five tools: list, search, get_component, get_component_markdown, get_host_rules.
  4. 4.Ask your agent to search a component and fetch get_component_markdown — scoped to that component only.

Cursor MCP config

{
  "mcpServers": {
    "akmanos": {
      "url": "https://akmanos.com/api/mcp"
    }
  }
}

Terminal smoke test from the repo root: npm run mcp

Public endpoints

  • /api/mcp — hosted MCP (Cursor url)
  • /api/mcp/components?action=list — CLI + scripts
  • /api/mcp/components?id={id}&format=markdown — component-only markdown

Markdown is scoped to one component — not the full site globals.css.

← Back home·Browse components