Guide

MCP Tools Reference

Complete reference for all AlphaTales MCP tools available in your IDE

5 min read

What you'll learn

  • Understand all 14 MCP tools and what they do
  • Know when to use each tool during development
  • Learn the normal project-to-feature workflow

Overview

When you connect your IDE to AlphaTales, your coding assistant can use 14 AlphaTales tools. These tools help it read project context, select the active project, inspect feature work, and update assignment or progress.

Tip: AlphaTales tool names start with at_ so they are easy to recognize when your IDE has more than one connected tool source.

Project Tools

Use project tools at the start of a session or when switching between projects.

ToolWhat it doesWhen to use it
at_projects_listLists projects you can accessFind the project you want to work on
at_projects_setSets the active projectSelect the project for later tools
at_projects_getCurrentShows the active projectConfirm the selected project
at_projects_initReturns project planning and architecture contextGive your assistant the project setup before coding
at_projects_bootstrapPlans a project initialization workflowStart a new project implementation from AlphaTales context
at_projects_addAgentSupportAdds support files for a selected coding toolAdd another IDE or assistant workflow to an existing project

Feature Work Tools

Use feature work tools after a project is selected. These tools focus on feature assignments, progress, and implementation context.

ToolWhat it doesWhen to use it
at_tasks_myLists features assigned to youCheck your current work
at_tasks_listLists features in the active projectReview available work
at_tasks_getDetailsShows full details for a featureUnderstand scope before starting
at_tasks_startMarks a feature as in progressSignal that work has started
at_tasks_completeMarks a feature as doneClose completed work
at_tasks_assignToMeAssigns a feature to youClaim unassigned work
at_tasks_unassignRemoves your assignmentRelease work you cannot continue
at_tasks_nextRecommends and starts the next featureLet AlphaTales pick the next best item

Typical Workflow

Start by asking your assistant to list your AlphaTales projects. Then set the active project before asking for project context or feature work.

For a normal development session:

  1. List projects with at_projects_list.
  2. Set the active project with at_projects_set.
  3. Load project context with at_projects_init.
  4. Review assigned or available work with at_tasks_my or at_tasks_list.
  5. Open one feature with at_tasks_getDetails.
  6. Start the feature with at_tasks_start.
  7. Mark it done with at_tasks_complete when finished.

Recover From Tool Issues

If your IDE cannot see the tools, reconnect the AlphaTales MCP server and authenticate again. If the active project is wrong, set it again with at_projects_set.

If a tool says you do not have access, check that you can open the project in AlphaTales. If your session expired, complete the IDE authentication flow again.

Next Steps

Return to What is MCP Integration for an overview, or use the connection guides to set up Cursor, Claude Code, Codex, GitHub Copilot, Antigravity, or another compatible tool.

Related guides