MCP Tools

MCP Tools Reference

35+ tools your AI coding assistant can use to query team context, create plans, manage handoffs, and more — all from within your coding session.

How MCP Works

The TeamContext MCP server runs locally via teamctx mcp-serve and communicates over stdio. It's configured automatically during teamctx setup via a .mcp.json file in your project root.

Your AI coding assistant (Claude Code, Cursor, Windsurf, etc.) connects to this server and gains access to all TeamContext tools. It can then answer questions like:

  • "Who else is working on the auth module?"
  • "What decisions were made about the database schema?"
  • "Create a plan for implementing the payment system"
  • "Are there any file conflicts I should know about?"

Instruction files (CLAUDE.md, AGENTS.md, GEMINI.md) are also installed to tell your AI when and how to use these tools.

Activity & Status Tools

get_team_status

See who is online, what branch they're on, and what they're working on.

Parameters: None

Returns: List of team members with name, branch, working on, files today, last activity, online status

Ask your AI: "Who's online right now?" or "What branch is Sarah working on?"

get_recent_activity

Get recent coding activity from the team.

Parameters: author (optional), limit (default: 10), source (optional: git-hook, claude-code-cli), branch (optional)

Returns: List of turns with summaries, models, files touched, tools used, duration

Ask your AI: "What has the team been working on today?" or "Show me Marcus's recent activity"

get_file_history

See who last touched a specific file and what they did.

Parameters: file_path (required)

Returns: List of turns that touched that file

Ask your AI: "Who last modified auth.service.ts and why?"

search_turns

Full-text search across all captured coding sessions.

Parameters: query (required), branch (optional)

Returns: Matching turns with pagination

Ask your AI: "Search for discussions about rate limiting"

Context & Intelligence Tools

get_summary

Get the latest AI-generated daily or weekly summary of team activity.

Parameters: type (optional: daily, weekly; default: daily), branch (optional)

Returns: Summary with content, highlights, and time period

Ask your AI: "Give me this week's team summary"

get_knowledge_base

List AI-generated knowledge articles from your team's coding sessions.

Parameters: type (optional: daily, weekly, member), limit (default: 10, max: 100), branch (optional)

Returns: List of summaries with titles, content, highlights, and time periods

Ask your AI: "What does the knowledge base say about our API design?"

get_decisions

Get architectural and technical decisions made by the team.

Parameters: category (optional: architecture, technology, convention, security, infrastructure), limit (default: 10), branch (optional), projectId (optional)

Returns: Decisions with title, description, rationale, category, alternatives, affected files

Ask your AI: "What architecture decisions were made this week?" or "Why did we choose PostgreSQL?"

get_project_context

Get the full technical context document for a project — architecture, modules, stack, dependencies, patterns.

Parameters: project_name (optional; auto-detects from git remote if omitted)

Returns: Complete markdown document with technical overview

Ask your AI: "What's the architecture of this project?" or "Explain this project's tech stack"

Conflict Detection

detect_conflicts

Check if anyone else is working on overlapping files or systems.

Parameters: None

Returns: List of active conflicts with members and overlapping files

Ask your AI: "Are there any conflicts with what I'm working on?" or "Is anyone else editing the auth module?"

Handoff Tools

create_handoff

Create a handoff document for your current work so a teammate can pick up where you left off.

Parameters: title (required), whats_done (required), whats_left (required), gotchas (optional)

Ask your AI: "Create a handoff for my current work on the payment integration"

get_handoffs

List active handoffs for your team.

Parameters: status (optional: active, picked_up, completed)

Ask your AI: "Are there any handoffs waiting for me?"

pickup_handoff / complete_handoff

Pick up a handoff to start working on it, or mark one as completed.

Parameters: handoff_id (required)

Ask your AI: "Pick up the auth middleware handoff" or "Mark handoff xyz as complete"

Plan Tools

generate_plan

Generate an AI-powered implementation plan with tasks, gap analysis, risks, and verification steps.

Parameters: title (required), description (required), project_id (optional), plan_id (optional — regenerate existing)

Ask your AI: "Create a plan for migrating the auth system to OAuth 2.0"

list_plans / get_plan / get_plan_markdown

List, view, or export plans.

Parameters: status (optional filter), limit (optional), plan_id (for detail/markdown)

Ask your AI: "Show me all in-progress plans" or "Get the full plan for the docs overhaul"

update_plan / update_plan_task / approve_plan

Update plan fields, change task statuses (auto-recalculates progress), or approve plans for execution.

Parameters: plan_id (required), task_id + status (for task updates), title, description, status (for plan updates)

Ask your AI: "Mark the auth task as completed" or "Approve the migration plan"

convert_plan_to_tasks

Convert a plan's tasks into individual sprint tasks, optionally assigning them to a sprint.

Parameters: plan_id (required), sprint_id (optional)

Ask your AI: "Convert the approved plan into sprint tasks"

Task & Sprint Tools

create_task / update_task / list_tasks / get_task

Full task management — create, update, list, and view tasks with priority, labels, assignees, and sprint association.

Parameters: title, description, assignee_id, priority (low/medium/high/urgent), labels, project_id, sprint_id, status

Ask your AI: "Create a high-priority task for fixing the login bug" or "List all tasks assigned to me"

add_task_comment / link_session_to_task

Add comments to tasks or link coding sessions for full context tracking.

Parameters: task_id (required), content (for comments), session_id (for linking)

Ask your AI: "Add a note to the auth task: found the root cause in middleware"

create_sprint / list_sprints

Create and list sprints with goals and date ranges.

Parameters: title (required), goal (optional), start_date / end_date (ISO 8601), project_id

Ask your AI: "Create a 2-week sprint for the API migration"

Agent Findings Tools

Query results from AI code analysis agents (Architecture Review, Security Audit, QA Coverage, HIPAA Compliance, Performance Analyzer).

list_agent_findings

List findings with filters by agent, project, severity, and status.

Parameters: agent_id (optional), project_id (optional), severity (optional: critical, high, medium, low, info), status (optional: open, dismissed, resolved), limit (default: 20)

Ask your AI: "Show me all critical security findings" or "List open findings for this project"

get_finding_detail / get_findings_stats

View full details of a finding or get aggregate stats by severity, status, agent, and project.

Parameters: finding_id (for detail)

Ask your AI: "How many critical findings do we have?" or "Show details of finding xyz"

dismiss_finding / resolve_finding

Dismiss a finding as not relevant, or mark it as resolved.

Parameters: finding_id (required)

Ask your AI: "Dismiss the N+1 query finding — it's already fixed"

Agents

list_agents

List agents agents subscribed by your team.

Parameters: None

Returns: List of subscribed agents with metadata, scan status, and finding counts

Ask your AI: "What agents are we subscribed to?" or "Show our agent scan results"