High-performance, compact Linear client & MCP server for AI agents. Reduces prompt context payload by 70–80% with persistent auth, CLI, skills & git hooks.
Belifoa demonstrates solid tool definition fundamentals with complete schemas, clear descriptions, and thoughtful parameter design. All 8 tools have explicit schemas with type definitions and descriptions. Tool names follow verb_noun conventions (get_issue, search_issues, manage_issue). Descriptions are substantive (100-250 chars typical), explaining WHAT the tool does and WHEN to use it. However, several gaps prevent a higher score: (1) manage_issue is a mega-tool combining 8 distinct actions (create/update/comment/close/resolve/delete_comment/archive_comment/bulk_create), violates single-responsibility principle; (2) output schemas are not documented, LLMs cannot predict response structure; (3) error handling lacks recovery guidance; (4) some parameter descriptions could be more prescriptive about constraints (e.g., format validation for dueDate, priority ranges). The server shows production intent but needs refinement for A-grade quality.
Check current active profile, all saved profiles, workspace organization, and viewer info. Pass profileName to inspect a different workspace.
Switch active authentication profile, workspace, or default team.
Get detailed information for a Linear issue (e.g. ENG-123) with compact agent-optimized output.
Get issues assigned to the authenticated user. Supports cursor pagination via 'after'.
Get teams, projects, and issue labels available in the workspace.
Unified tool to create, update, comment, close, resolve, or bulk create Linear issues in a single action call.
manage_issue combines 8 distinct actions (create, update, comment, close, resolve, delete_comment, archive_comment, bulk_create) into a single tool. Violates single-responsibility principle, LLMs struggle to reason about which action to invoke and parameter relevance varies by action.
Output schemas are not documented for any tool. LLMs cannot predict response structure, field names, or types. This forces agents to guess at downstream field names and risks broken tool chains.
Error handling lacks recovery guidance. No indication of which errors are retryable, user-fixable, or fatal. Errors should guide LLM to next action (e.g., 'Issue not found. Try search_issues() first.').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Search Linear issues by keyword query, team, or status. Results are re-ranked by title/description/label/comment token overlap and each row shows which query tokens matched where (t:/d:/l:/c:). Supports cursor pagination via 'after'.
Add or set a long-lived Linear Personal API Key for a profile/workspace.
Parameter constraints not fully specified. dueDate lacks format validation (YYYY-MM-DD). priority enum values (1-4) not enforced in schema. estimate enum present but description could clarify Fibonacci scale. Agents may pass invalid values.
Pagination support present (limit, after, endCursor) but not consistently documented. search_issues and get_my_issues support pagination; descriptions mention 'cursor pagination' but do not explain when to use 'after' or what 'endCursor' contains.