Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODECKS_TOKEN | No | Session cookie value (named 'at') found in Browser DevTools. Used for authentication. | |
| CODECKS_ACCOUNT | No | Your Codecks account slug. | |
| CODECKS_USER_ID | No | Specific User ID. Auto-discovered if unset. | |
| CODECKS_REPORT_TOKEN | No | A non-expiring token generated via the CLI 'generate-token' command. Alternative to CODECKS_TOKEN. | |
| CODECKS_HTTP_MAX_RETRIES | No | The number of times to retry failed HTTP requests. | 2 |
| CODECKS_MCP_RESPONSE_MODE | No | Sets the response format. Can be 'legacy' or 'envelope'. | legacy |
| CODECKS_HTTP_TIMEOUT_SECONDS | No | Request timeout in seconds. | 30 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_account | Get current account info (name, id, email, role). |
| list_cards | List cards. Filters combine with AND. |
| get_card | Get full card details (content, checklist, sub-cards, conversations, hand status). |
| list_decks | List all decks. Set include_card_counts=True for per-deck counts. |
| list_projects | List all projects with deck info. |
| list_milestones | List all milestones with card counts. |
| list_tags | List project-level tags (sanctioned taxonomy). |
| list_activity | Show recent activity feed. |
| pm_focus | PM focus dashboard: blocked, stale, unassigned, and suggested next cards. |
| standup | Daily standup summary: recently done, in-progress, blocked, and hand. |
| list_hand | List cards in the user's hand (personal work queue), sorted by hand order. |
| add_to_hand | Add cards to the user's hand. |
| remove_from_hand | Remove cards from the user's hand. |
| create_card | Create a new card. Set deck/project to place it. Use parent to nest as sub-card. |
| update_cards | Update card properties. Doc cards: only owner/tags/milestone/deck/title/content/hero. |
| mark_done | Mark cards as done. |
| mark_started | Mark cards as started. |
| archive_card | Archive a card (reversible). |
| unarchive_card | Restore an archived card. |
| delete_card | Permanently delete a card. Cannot be undone — use archive_card if reversibility needed. |
| scaffold_feature | Create a Hero card with Code/Design/Art/Audio sub-cards. |
| split_features | Batch-split unsplit feature cards into lane sub-cards. Use dry_run=true to preview. |
| create_comment | Start a new comment thread on a card. |
| reply_comment | Reply to an existing comment thread. |
| close_comment | Close (resolve) a comment thread. |
| reopen_comment | Reopen a closed comment thread. |
| list_conversations | List all comment threads on a card with messages and thread IDs. |
| get_pm_playbook | Get PM session methodology guide. No auth needed. |
| get_workflow_preferences | Load user workflow preferences from past sessions. No auth needed. |
| save_workflow_preferences | Save observed workflow patterns from current session. No auth needed. |
| save_cli_feedback | Save a CLI feedback item for the development team. No auth needed. |
| get_cli_feedback | Read saved CLI feedback items. Optionally filter by category. No auth needed. |
| planning_init | Create lean planning files (task_plan.md, findings.md, progress.md) in project root. No auth needed. |
| planning_status | Get compact planning status: goal, phases, decisions, errors, token count. No auth needed. |
| planning_update | Update planning files mechanically. No auth needed. Operations: goal, advance, phase_status, error, decision, finding, issue, log, file_changed, test. |
| planning_measure | Track token usage of planning files over time. No auth needed. Operations: snapshot, report, compare_templates. |
| get_tag_registry | Get the local tag taxonomy (definitions, hero tags, lane-tag mappings). No auth needed. |
| get_lane_registry | Get the local lane (deck category) definitions and metadata. No auth needed. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |