Guide
MCP Tools Reference
Complete reference for all AlphaTales MCP tools available in your IDE
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.
| Tool | What it does | When to use it |
|---|---|---|
at_projects_list | Lists projects you can access | Find the project you want to work on |
at_projects_set | Sets the active project | Select the project for later tools |
at_projects_getCurrent | Shows the active project | Confirm the selected project |
at_projects_init | Returns project planning and architecture context | Give your assistant the project setup before coding |
at_projects_bootstrap | Plans a project initialization workflow | Start a new project implementation from AlphaTales context |
at_projects_addAgentSupport | Adds support files for a selected coding tool | Add 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.
| Tool | What it does | When to use it |
|---|---|---|
at_tasks_my | Lists features assigned to you | Check your current work |
at_tasks_list | Lists features in the active project | Review available work |
at_tasks_getDetails | Shows full details for a feature | Understand scope before starting |
at_tasks_start | Marks a feature as in progress | Signal that work has started |
at_tasks_complete | Marks a feature as done | Close completed work |
at_tasks_assignToMe | Assigns a feature to you | Claim unassigned work |
at_tasks_unassign | Removes your assignment | Release work you cannot continue |
at_tasks_next | Recommends and starts the next feature | Let 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:
- List projects with
at_projects_list. - Set the active project with
at_projects_set. - Load project context with
at_projects_init. - Review assigned or available work with
at_tasks_myorat_tasks_list. - Open one feature with
at_tasks_getDetails. - Start the feature with
at_tasks_start. - Mark it done with
at_tasks_completewhen 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.