{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kz6mbfakp5zx","handle":"cargoeffe-mcp","url":"https://wellknown.network/agents/cargoeffe-mcp","links":{"self":"https://wellknown.network/agents/cargoeffe-mcp/record.json","html":"https://wellknown.network/agents/cargoeffe-mcp","markdown":"https://wellknown.network/agents/cargoeffe-mcp/record.md","api":"https://wellknown.network/api/v1/agents/cargoeffe-mcp","status":"https://wellknown.network/api/v1/agents/cargoeffe-mcp/status","claim":"https://wellknown.network/agents/cargoeffe-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/cargoeffe-mcp/claim.json","badge":"https://wellknown.network/agents/cargoeffe-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:cargoeffe-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"cargoeffe-mcp","summary":"MCP server for CargoEffe — AI-powered cargo loading plan design","description":"# CargoEffe MCP Server\n\nConnect AI assistants (Claude Desktop, Claude Code, Cursor) to CargoEffe for automated cargo loading plan design.\n\n## Installation\n\n```bash\n# Option A: pip install\npip install cargoeffe-mcp\n\n# Option B: uvx (no pre-install needed)\nuvx cargoeffe-mcp\n\n# Option C: from source\ngit clone https://github.com/dollob/cargoeffe-mcp.git\ncd cargoeffe-mcp && pip install -e .\n```\n\n## Setup\n\n1. Get your MCP token from CargoEffe Settings → MCP Tokens\n2. Configure your AI client:\n\n### Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"cargoeffe\": {\n      \"command\": \"uvx\",\n      \"args\": [\"cargoeffe-mcp\"],\n      \"env\": {\n        \"CARGOEFFE_MCP_TOKEN\": \"cfm_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"cargoeffe\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"cargoeffe_mcp.server\"],\n      \"env\": {\n        \"CARGOEFFE_MCP_TOKEN\": \"cfm_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n## Debug Mode\n\nSet `CARGOEFFE_MCP_DEBUG=true` for verbose logging:\n\n```json\n{\n  \"env\": {\n    \"CARGOEFFE_MCP_TOKEN\": \"cfm_...\",\n    \"CARGOEFFE_MCP_DEBUG\": \"true\"\n  }\n}\n```\n\nDebug logs appear on stderr (visible in Claude Code's MCP debug panel).\n\n## Available Tools\n\n| Tool | Description |\n|---|---|\n| `get_context` | Read CargoEffe system context (coordinates, rules) — free |\n| `get_axle_templates` | List axle templates with weight limits — free |\n| `plan_create` | Create a new load plan |\n| `plan_load` | Load plan by ID |\n| `plan_list` | List your plans |\n| `plan_save` | Save plan to backend |\n| `container_list` | List available containers |\n| `container_set` | Set container for a plan |\n| `cargo_add` | Add cargo items (bulk) |\n| `cargo_list` | List cargo items |\n| `cargo_update` | Update cargo properties |\n| `cargo_remove` | Delete cargo + placements |\n| `group_create` | Create loading group |\n| `group_list` | List loading groups |\n| `group_update` | Rename/reorder groups |\n| `save_placements` | Save AI-calc…","publisher":{"name":"dollob studio","url":null},"homepage":null,"repository":null,"version":"0.3.0","license":"MIT","protocols":["mcp"],"tags":["ai","cargo","loading","logistics","mcp"],"pricing":null,"endpoints":[{"url":"pypi:cargoeffe-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"cargoeffe-mcp","registry":"pypi","observedAt":"2026-09-09T11:32:30.025Z","publishedAt":"2026-07-09T23:06:13.901773Z","latestVersion":"0.3.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"cargoeffe-mcp","url":"https://pypi.org/project/cargoeffe-mcp/","firstSeenAt":"2026-09-09T11:29:40.362Z","fetchedAt":"2026-09-09T11:29:40.362Z","normalizedAt":"2026-09-09T11:29:40.362Z"}]},"firstSeenAt":"2026-09-09T11:29:40.362Z","updatedAt":"2026-09-09T11:32:30.025Z"}