# AimYear (io.github.Yahhi/aimyear-mcp): tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.github.Yahhi%2Faimyear-mcp/versions/latest)
- Connected to: https://mcp.aimyear.com/mcp
- Homepage: https://aimyear.com/
- Repository: https://github.com/Yahhi/aimyear-mcp
- Scoring rules: v2
- Tools: 52
- Average: 44.0 / 100 (Cloudy)
- Near-identical pairs: 0

This page shows how AimYear (io.github.Yahhi/aimyear-mcp)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

- Major: 52 tools. Above 40, models choose less accurately.
- Minor: The server's instructions are 2232 characters. Claude Code reads only the first 2,048 by default (Codex 0.154.0 reads them whole). Put what the server is for first.

## Tools

- `delete_device`: 16 / 100
  - Major: The description only restates the name (8 words).
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: token.
  - Minor: String arguments with no constraint or example: token.
  - Minor: Says nothing about what it returns.
- `delete_step`: 16 / 100
  - Major: The description only restates the name (6 words).
  - Major: The description is too short (6 words).
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: stepId.
  - Minor: String arguments with no constraint or example: stepId.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: stepId. Name the tool or the place that returns it, or models look it up first.
- `edit_step`: 21 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: stepId, title, status, order, leverId, estimateMin.
  - Minor: String arguments with no constraint or example: stepId, title, leverId.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: stepId. Name the tool or the place that returns it, or models look it up first.
- `delete_social_account`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: network.
  - Minor: Says nothing about what it returns.
- `next_steps`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: count.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `set_projects`: 32 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: projects, projects[].id, projects[].name, projects[].area, projects[].keywords, projects[].repos.
  - Minor: String arguments with no constraint or example: projects[].id, projects[].name.
  - Minor: Says nothing about what it returns.
- `get_plan`: 33 / 100
  - Major: The description only restates the name (7 words).
  - Major: The description is too short (7 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `list_sessions`: 33 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: area, projectId.
  - Minor: String arguments with no constraint or example: projectId.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `set_settings`: 33 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: timezone, workplace, workMin, breakMin, longBreakEvery, longBreakMin, standup.
  - Minor: String arguments with no constraint or example: timezone.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The meaning of the boolean argument standup is unclear.
  - Minor: Says nothing about what it returns.
- `delete_agent`: 35 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: client_id.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: client_id. Name the tool or the place that returns it, or models look it up first.
- `edit_plan_item`: 36 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: itemId, done, title, area, projectId, leverId, stepId, isMainStep, estimateMin.
  - Minor: String arguments with no constraint or example: itemId, title, projectId, leverId, stepId.
  - Minor: The meaning of the boolean argument done is unclear.
  - Minor: The meaning of the boolean argument isMainStep is unclear.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: itemId. Name the tool or the place that returns it, or models look it up first.
- `delete_plan_item`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: itemId.
  - Minor: String arguments with no constraint or example: itemId.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: itemId. Name the tool or the place that returns it, or models look it up first.
- `set_day_mode`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: mode.
  - Minor: Says nothing about what it returns.
- `set_levers`: 37 / 100
  - Major: Arguments without a description: levers, levers[].id, levers[].name, levers[].kind, levers[].examples, levers[].keywords, levers[].repos.
  - Minor: String arguments with no constraint or example: levers[].id, levers[].name.
  - Minor: Says nothing about what it returns.
- `split_attention`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: shares.
  - Minor: Says nothing about what it returns.
- `add_device`: 38 / 100
  - Major: Arguments without a description: token, platform, label.
  - Minor: String arguments with no constraint or example: label.
  - Minor: Says nothing about what it returns.
- `add_steps`: 38 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: milestoneId, steps, steps[].title, steps[].leverId, steps[].estimateMin.
  - Minor: String arguments with no constraint or example: milestoneId, steps[].title, steps[].leverId.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: milestoneId. Name the tool or the place that returns it, or models look it up first.
- `add_note`: 39 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: note.
  - Minor: String arguments with no constraint or example: note.
  - Minor: Says nothing about what it returns.
- `edit_milestone`: 40 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: milestoneId, title, metric, target, status.
  - Minor: String arguments with no constraint or example: milestoneId, title, metric.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: milestoneId. Name the tool or the place that returns it, or models look it up first.
- `find_gaps`: 41 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `summarize_day`: 41 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `summarize_week`: 41 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `add_session`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: task, minutes, projectId, leverId.
  - Minor: String arguments with no constraint or example: task, projectId, leverId, stepId, itemId.
  - Minor: Says nothing about what it returns.
- `set_milestones`: 43 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: milestones, milestones[].id, milestones[].title, milestones[].metric, milestones[].target.
  - Minor: String arguments with no constraint or example: milestones[].id, milestones[].title, milestones[].metric.
  - Minor: Says nothing about what it returns.
- `find_leaks`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `get_planning_context`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `get_post_draft`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `set_plan`: 44 / 100
  - Major: Arguments without a description: items, items[].title, items[].area, items[].projectId, items[].leverId, items[].stepId, items[].isMainStep, items[].estimateMin.
  - Minor: String arguments with no constraint or example: items[].title, items[].projectId, items[].leverId, items[].stepId.
  - Minor: The meaning of the boolean argument items[].isMainStep is unclear.
  - Minor: Says nothing about what it returns.
- `get_capacity`: 46 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `get_commitments`: 46 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `get_settings`: 46 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `set_goal`: 48 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: title, why.
  - Minor: String arguments with no constraint or example: title, why.
  - Minor: Says nothing about what it returns.
- `set_routines`: 48 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: routines, routines[].id, routines[].title, routines[].area, routines[].projectId, routines[].leverId, routines[].days.
  - Minor: String arguments with no constraint or example: routines[].id, routines[].title, routines[].projectId, routines[].leverId.
  - Minor: Says nothing about what it returns.
- `delete_session`: 49 / 100
  - Minor: String arguments with no constraint or example: session_id.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `get_goal`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `get_insights`: 49 / 100
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `get_path`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `stop_timer`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: summary.
  - Minor: String arguments with no constraint or example: summary.
  - Minor: No `required` list, so every argument is optional.
- `list_devices`: 50 / 100
  - Minor: Says nothing about what it returns.
- `get_now`: 51 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `add_post`: 52 / 100
  - Minor: Arguments without a description: text.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `record_progress`: 52 / 100
  - Minor: Arguments without a description: value.
  - Minor: Says nothing about what it returns.
- `stop_session`: 52 / 100
  - Minor: Arguments without a description: summary, outcome.
  - Minor: String arguments with no constraint or example: summary.
  - Minor: Says nothing about what it returns.
- `set_commitments`: 53 / 100
  - Major: Arguments without a description: commitments, commitments[].id, commitments[].title, commitments[].days, commitments[].timesPerWeek, commitments[].minutes, commitments[].projectId, commitments[].note.
  - Minor: String arguments with no constraint or example: commitments[].id, commitments[].title, commitments[].projectId, commitments[].note.
  - Minor: Says nothing about what it returns.
- `list_agents`: 54 / 100
  - Minor: Says nothing about what it returns.
- `edit_session`: 56 / 100
  - Minor: Arguments without a description: session_id, task, projectId, leverId, summary, outcome.
  - Minor: String arguments with no constraint or example: session_id, task, projectId, leverId, stepId, itemId, summary.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: session_id. Name the tool or the place that returns it, or models look it up first.
- `set_tracks`: 58 / 100
  - Major: Arguments without a description: tracks, tracks[].id, tracks[].title, tracks[].milestoneIds.
  - Minor: String arguments with no constraint or example: tracks[].id, tracks[].title.
  - Minor: Says nothing about what it returns.
- `start_session`: 61 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: projectId, leverId, workplace.
  - Minor: String arguments with no constraint or example: projectId, leverId, stepId, itemId.
- `list_social_accounts`: 63 / 100
- `get_routines`: 64 / 100
  - Major: Says nothing about when to use it, or when not to.
- `add_social_account`: 66 / 100
  - Minor: Arguments without a description: network.
  - Minor: Says nothing about what it returns.
- `check_goal_draft`: 71 / 100
  - Minor: Arguments without a description: title, target.
  - Minor: String arguments with no constraint or example: title.
  - Minor: No `required` list, so every argument is optional.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)