AGILEX Docs MCP

Official product documentation for AgileX Robotics (松灵机器人) — user manuals, CAN 2.0B protocol references, firmware notes, SDK tech posts and after-sales FAQ for piper, pika, nero, ranger, limo, scout, bunker, hunter, tracer, umr, cobot_magic and aloha.

Point your AI coding assistant at this server before writing integration code for AgileX hardware, so it consults the real manual instead of guessing baud rates, frame formats or pinouts.

This repository documents the public interface. It covers the endpoint, the tool signatures and every client configuration. The indexing service that backs it is operated by AgileX and is not part of this repository.

---

Endpoint

MCP URL	https://service.agilex.ai/agilex-docs/mcp
Transport	Streamable HTTP — single endpoint, stateless
Protocol	2025-11-25 (also answers 2025-06-18, 2025-03-26, 2024-11-05)
Auth	None. Read-only public docs, rate limited per IP
Registry	ai.agilex.service/docs
Docs page	https://service.agilex.ai/agilex-docs/
Health	https://service.agilex.ai/agilex-docs/health

No API key, no OAuth, no local process. If your client speaks Streamable HTTP, you only need the URL.

---

Quick start

Clients are listed in order of how common they are. Pick one.

#	Client	Setup
1	Claude Code	claude mcp add --scope user --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp
2	Codex CLI	codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp
3	Cursor	one-click install, or the JSON below
4	VS Code / Copilot	Ctrl+Shift+P → MCP: Add Server → HTTP → paste the URL
5	Anything stdio-only	npx -y mcp-remote https://service.agilex.ai/agilex-docs/mcp

# 1) Claude Code — all projects
claude mcp add --scope user --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp

# 2) Codex CLI — writes ~/.codex/config.toml
codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp

Cursor one-click:

cursor://anysphere.cursor-deeplink/mcp/install?name=agilex-docs&config=eyJ1cmwiOiJodHRwczovL3NlcnZpY2UuYWdpbGV4LmFpL2FnaWxleC1kb2NzL21jcCJ9

Any client that reads mcpServers (Cursor, Claude Desktop, Cline, Windsurf, Cherry Studio, Continue, Zed, LibreChat, Dify …):

{
  "mcpServers": {
    "agilex-docs": {
      "url": "https://service.agilex.ai/agilex-docs/mcp"
    }
  }
}

Full per-client instructions: docs/CLIENTS.md.

---

Tools

Five read-only tools. The names are deliberately verb_noun so a model can pick the right one without reading the schema first.

Tool	Purpose	Parameters
search_docs	Full-text search. Start here. Locate before reading.	query (include the product name), limit (1–25, default 8), space (optional)
find_in_doc	Locate a passage inside one long manual; returns absolute offset	doc_id, query, limit (1–10, default 5)
get_doc	Read one page as Markdown, paginated	doc_id, max_chars (default 20 000, honoured as requested, max 120 000), offset
list_docs	Inventory of a single space	space (optional), limit (1–300, default 100), offset (≥0)
list_spaces	All public spaces with page counts	—

`search_doc

... View full README on GitHub