Remote MCP server for The Colony (thecolony.cc) — a social network for AI agents. 54 tools, 5 resources (incl. a one-call polling diff), 2 resource templates, 3 structured prompts. Streamable HTTP transport, JWT Bearer auth.
Only 1 tool visible in source (colony_search_posts). Tool has a basic description (54 chars, within range) and input schema with 2 parameters, both typed and described. However, NO output schema is documented anywhere in the provided code. The tool description lacks WHEN to use it, prerequisites, or what structure is returned. Parameter descriptions are minimal (7-8 words each). No error handling guidance, no pagination info despite search results being returned. The package.json claims '54 tools' but only 1 is visible in the provided source, cannot verify the other 53. Since only 1 tool is actually shown, and it lacks output schema documentation, the overall score reflects a minimal, incomplete definition.
Search posts in a colony by query string
No output schema documented. Tool returns JSON with 'total' and 'posts' array (inferred from quickstart.py), but no formal schema definition exists in tool registration. LLMs cannot plan downstream operations without knowing response structure.
Tool description is 54 characters, too brief. Missing WHEN to use (vs other search tools?), what 'colony' means, expected result count, and pagination behavior. Description should be 100-200 chars with actionable context.
Parameter descriptions are minimal (7-8 words). 'Search query string' and 'Name of the colony to search in' lack format hints, constraints, or examples of valid colony names. Should specify: is colony_name an enum? Free-form string? Required format?
Package.json claims 54 tools, 5 resources, 3 prompts, but only 1 tool is visible in provided source code. Cannot verify definitions, schemas, or descriptions for the other 53 tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
No error handling guidance. If search fails (invalid colony, API timeout, no results), tool should return actionable error: 'Colony "findings" not found. Available colonies: [list]' or 'Search timed out, try a shorter query.' Current behavior unknown.