Sprintra

https://sprintra.io/docs
Admin
Sprintra gives AI coding agents persistent memory, project structure, and decision traceability...
Tokens:13,827
Snippets:205
Trust Score:4.9
Update:1 month ago
Show doc for...
Tokens:
Raw
### Scaffold a local Sprintra instance

Source: https://sprintra.io/docs/getting-started

Use the installer to create a new project directory and start the local server.

```bash
npx create-sprintra my-project
cd my-project
npm start
```

--------------------------------

### Install and run @sprintra/cli

Source: https://sprintra.io/docs/cli

Commands to install the CLI globally or execute it directly using npx.

```bash
npm install -g @sprintra/cli

# Or run directly with npx (always latest)
npx @sprintra/cli@latest context
```

--------------------------------

### Install Sprintra CLI

Source: https://sprintra.io/docs/getting-started

Install the lightweight Sprintra CLI globally via npm.

```bash
npm install -g @sprintra/cli
```

--------------------------------

### Install Sprintra for Cursor

Source: https://sprintra.io/docs/install

Execute the CLI command to install the plugin for Cursor, replacing <id> with your project ID.

```bash
npx @sprintra/cli plugin install --ide=cursor --project=<id>
```

--------------------------------

### Install Skills via Claude Code Plugin

Source: https://sprintra.io/docs/skills

Use the plugin marketplace to install the Sprintra MCP plugin, which bundles all available skills.

```bash
# Inside Claude Code:
/plugin marketplace add Sprintra-io/sprintra-mcp
/plugin install sprintra@sprintra
```

--------------------------------

### Install Sprintra for Claude Code

Source: https://sprintra.io/docs/install

Use the plugin install command within the Claude Code environment.

```bash
/plugin install sprintra@sprintra
```

--------------------------------

### Launch Codex

Source: https://sprintra.io/docs/install/codex

Start the Codex CLI in your project root.

```bash
codex
```

--------------------------------

### Install and Configure Sprintra Memory

Source: https://sprintra.io/docs/memory-layer

Follow these commands to install the plugin, CLI, and index existing transcripts for memory recall.

```bash
# 1. Install the latest plugin
# Inside Claude Code:
/plugin marketplace add Sprintra-io/sprintra-mcp
/plugin install sprintra@sprintra

# 2. Install the CLI (with transcript subcommand)
npm install -g @sprintra/cli@latest

# 3. One-time backfill: index your existing transcripts
sprintra transcript reindex

# 4. Open a fresh Claude Code session — verify a "Relevant past
#    observations" section appears on session start once you have
#    a few sessions cached. The dashboard's Local memory cache tab
#    shows your cached count + last update.
```

--------------------------------

### Install Sprintra for Codex CLI

Source: https://sprintra.io/docs/install

Execute the CLI command to install the plugin for Codex, replacing <id> with your project ID.

```bash
npx @sprintra/cli plugin install --ide=codex --project=<id>
```

--------------------------------

### Implement feature with /implement

Source: https://sprintra.io/docs/skills

Loads feature context and starts implementation based on a specific feature ID.

```text
/implement feat-abc123

Feature: Payment Integration [high]
Stories (5):
  1. [todo] Stripe SDK setup — 2 SP
  2. [todo] Payment intent API — 3 SP
  3. [todo] Webhook handler — 3 SP
  4. [todo] Checkout UI — 3 SP
  5. [todo] E2E tests — 2 SP

Decisions affecting this feature:
  - dec-xyz: Use Stripe over PayPal

Starting with: Stripe SDK setup...
```

--------------------------------

### Sprintra CLI commands

Source: https://sprintra.io/docs/getting-started

Install the CLI globally to interact with project data directly from the terminal.

```bash
npm install -g @sprintra/cli

# Authenticate
sprintra login

# Auto-configure your AI tool
sprintra connect

# Quick project overview
sprintra context --project proj-abc123

# What should I work on next?
sprintra next-work --project proj-abc123
```

--------------------------------

### Manage Skills via Sprintra CLI

Source: https://sprintra.io/docs/skills

Use the standalone CLI to install, update, or list skills without the full plugin suite.

```bash
# In your terminal — useful if you only want skills, not the SessionStart hook
npx @sprintra/cli skills install --all

# Or install specific skills
npx @sprintra/cli skills install capture decide wrap

# Update installed skills to latest
npx @sprintra/cli skills update

# List available skills
npx @sprintra/cli skills list
```

--------------------------------

### Install Sprintra Plugin

Source: https://sprintra.io/docs/install/codex

Run this command from your project root to add the Sprintra MCP entry to your Codex configuration.

```bash
npx @sprintra/cli@latest plugin install \
  --ide=codex \
  --project=<your-project-id>
```

--------------------------------

### dependencies.get_graph

Source: https://sprintra.io/docs/mcp-tools

Get full dependency graph.

```APIDOC
## dependencies.get_graph

### Description
Get full dependency graph.

### Parameters
- **project_id** - Required
```

--------------------------------

### Start a brainstorming session

Source: https://sprintra.io/docs/skills

Use the /brainstorm command to engage with specific AI personas based on project context.

```text
/brainstorm MyProject architect

Loading project context...
Adopting: Technical Architect persona

Project: MyProject [active]
Features: 12 (3 done, 5 in progress, 4 todo)
Sprint: Sprint 3 — API Layer (65% complete)

As your technical architect, I see a few areas
to discuss...
```

--------------------------------

### /brainstorm [topic]

Source: https://sprintra.io/docs/skills

Starts a brainstorming session with AI personas.

```APIDOC
## /brainstorm [topic]

### Description
Starts a brainstorming session with one of six AI personas (project_manager, technical_architect, skeptical_reviewer, sprint_planner, product_manager, or feature_planner) using full project context.

### Parameters
#### Path Parameters
- **topic** (string) - Required - The topic for the brainstorming session.
```

--------------------------------

### GET /api/agent/context

Source: https://sprintra.io/docs/mcp-tools

Retrieves a full project snapshot including sprint progress, in-progress stories, decisions, blockers, and activity.

```APIDOC
## GET /api/agent/context

### Description
Retrieves a full project snapshot in one call, including current sprint progress, in-progress stories, recent decisions, active blockers, last work session, activity feed, and stats.

### Method
GET

### Endpoint
/api/agent/context

### Parameters
#### Query Parameters
- **project_id** (string) - Required - The unique identifier of the project.
```

--------------------------------

### executions.get

Source: https://sprintra.io/docs/mcp-tools

Get a single execution by ID.

```APIDOC
## executions.get

### Description
Get a single execution by ID.

### Parameters
- **execution_id** (string) - Required
```

--------------------------------

### GET /api/agent/next-work

Source: https://sprintra.io/docs/mcp-tools

Provides a recommended next story with full context, including feature details, decisions, and dependencies.

```APIDOC
## GET /api/agent/next-work

### Description
Returns a recommended next story with full context, including feature details, related decisions, dependencies, and a readiness score.

### Method
GET

### Endpoint
/api/agent/next-work

### Parameters
#### Query Parameters
- **project_id** (string) - Required - The unique identifier of the project.
```

--------------------------------

### pull_requests.get_story_prs

Source: https://sprintra.io/docs/mcp-tools

Get pull requests linked to a specific story.

```APIDOC
## pull_requests.get_story_prs

### Description
Get pull requests linked to a specific story.

### Parameters
- **story_id** (string) - Required
```

--------------------------------

### Bind and Initialize Sprintra Project

Source: https://sprintra.io/docs/teams

Commands for team leads to link a repository to a project and for teammates to authenticate their local environment.

```bash
# Team lead (one time, then commit):
npx @sprintra/cli@latest link --project=proj-XXXXXXXX
git add .sprintra/project.json
git commit -m "chore: bind repo to Sprintra project proj-XXXXXXXX"
git push

# Each teammate clones — auto-detects on first Claude Code session:
git clone <repo>
cd <repo>
cat .sprintra/project.json   # already there from the clone
npx @sprintra/cli@latest login    # one-time per machine — paste their personal token
claude                            # next session shows [sprintra] briefing automatically
```

--------------------------------

### Project Linking

Source: https://sprintra.io/docs/cli

Bind a local directory to a Sprintra project to enable context fetching.

```bash
sprintra link --project=<id> [--project-key=<key>] [--path=<dir>] [--force]
```

```bash
$ sprintra link --project=proj-XXXXXXXX --project-key=YOURKEY

  ✓ Created marker at /your/repo/.sprintra/project.json
```

--------------------------------

### Activity and Context

Source: https://sprintra.io/docs/cli

Retrieve project activity, snapshots, and AI-optimized summaries.

```bash
sprintra activity [--limit <n>]
```

```bash
sprintra context
```

```bash
$ sprintra context

  Sprintra [active]
  The project brain for AI coding agents

  Sprint: Sprint 14 — Session Replay
  Progress: 12/18 stories (67%)
  Ends: 2026-03-21

  In Progress (3):
    s-abc123  Payment webhook handler  Payments
    s-def456  Auth middleware refactor  Authentication

  Stats: 61/70 features | 340/380 stories
```

```bash
sprintra next-work
```

```bash
$ sprintra next-work

  Next: Implement Stripe webhook signature verification
  ID: s-ghi789  Type: story  Points: 3
  Readiness: 85%
  Feature: Payment Integration [high]

  Acceptance Criteria:
    - Verify webhook signatures using Stripe SDK
    - Handle duplicate events idempotently
    - Log failed verifications to Sentry
```

```bash
sprintra briefing
```

```bash
sprintra delta
```

```bash
sprintra status
```

```bash
$ sprintra status

  Sprintra CLI v0.6.0
  Server: https://api.sprintra.io
  Mode: production
  Status: ok
  DB: ok (3ms)
  Token: set
  Project: proj-XXXXXXXX
```

--------------------------------

### Link Directory to Sprintra Project

Source: https://sprintra.io/docs/install/claude-code

Execute this command from your project root to create the .sprintra/project.json file required for session hooks.

```bash
npx @sprintra/cli@latest plugin link \
  --project=<your-project-id>
```

--------------------------------

### Authenticate and Link Project

Source: https://sprintra.io/docs/getting-started

Perform one-time authentication and link your current directory to a specific Sprintra project.

```bash
# In your terminal (one-time):
npx @sprintra/cli login

# In your project repo (one-time per repo):
npx @sprintra/cli link --project=<your-project-id>
```

--------------------------------

### Configure Shared Sprintra Server

Source: https://sprintra.io/docs/teams

Commands to set up and connect to a shared Sprintra server using different networking options.

```bash
# On the host machine (e.g. team lead's Mac mini):
npx create-sprintra@latest team-server
cd team-server
HOST=0.0.0.0 PORT=4000 npm start
# Find the LAN IP: ipconfig getifaddr en0 (Mac) or hostname -I (Linux)

# On each teammate's machine:
echo '{"apiUrl":"http://<lan-ip>:4000","token":"<shared-or-per-user-token>"}' > ~/.sprintra/config.json
```

```bash
# Install Tailscale on host + all teammates' machines (https://tailscale.com)
# Host runs server bound to 0.0.0.0:
HOST=0.0.0.0 PORT=4000 npm start
# Teammates find host's tailnet hostname (e.g. team-server.<tailnet>.ts.net)
# Set apiUrl in each teammate's config.json:
echo '{"apiUrl":"http://team-server.your-tailnet.ts.net:4000","token":"..."}' > ~/.sprintra/config.json
```

```bash
# Run Sprintra in Docker on a small VPS (Hetzner, Fly.io, Railway):
# Then teammates point at the public URL with HTTPS:
echo '{"apiUrl":"https://sprintra.your-company.com","token":"..."}' > ~/.sprintra/config.json
```

--------------------------------

### Perform sprint planning

Source: https://sprintra.io/docs/skills

Use the /sprint-plan command to analyze project progress and receive AI-driven recommendations for sprint composition.

```text
/sprint-plan

Sprint Progress Summary:
  Sprint 5 [active]: 8/12 stories (67%)
  Sprint 6 [planning]: 0 stories assigned

Unplanned Features (4):
  - Payment Integration [high] — 5 stories, 15 SP
  - Email Notifications [medium] — 3 stories, 8 SP
  ...

Recommendation: Assign Payment Integration
to Sprint 6 (highest priority, no blockers)
```

--------------------------------

### AI Tool Integration

Source: https://sprintra.io/docs/cli

Configure plugins and MCP servers for AI coding assistants.

```bash
sprintra plugin install [--ide=claude-code|cursor|codex|antigravity|gemini-cli]
```

```bash
$ npx @sprintra/cli@latest plugin install

  ✓ Installed Claude Code plugin
  ✓ Wired SessionStart, UserPromptSubmit, Stop hooks
  ✓ Registered MCP server in ~/.claude.json

  Restart Claude Code to activate.
```

```bash
sprintra connect
```

```bash
$ sprintra connect

  Detected: Claude Code
  Updated: ~/.claude.json
  MCP server configured. Restart Claude Code to activate.
```

```bash
sprintra mcp
```

--------------------------------

### Authentication Commands

Source: https://sprintra.io/docs/cli

Commands for managing user sessions and personal access tokens.

```bash
sprintra login
```

```bash
sprintra logout
```

```bash
sprintra whoami
```

```bash
sprintra token create <name>
```

```bash
$ sprintra token create my-cursor-token
Token created: spt_abc123...
Copy this token — it won't be shown again.
```

```bash
sprintra token list
```

```bash
sprintra token revoke <id>
```

--------------------------------

### Connect Sprintra MCP Server

Source: https://sprintra.io/docs/getting-started

Use this command to configure Cursor, Claude Desktop, or Windsurf with the Sprintra MCP server if not using Claude Code.

```bash
npx @sprintra/cli connect
```

--------------------------------

### Verify MCP Connection

Source: https://sprintra.io/docs/install/codex

List configured MCP servers to confirm the Sprintra plugin is enabled.

```bash
codex mcp list
```

--------------------------------

### Authenticate via CLI

Source: https://sprintra.io/docs/teams

Command to authenticate a user and cache identity locally.

```bash
npx @sprintra/cli@latest login
```

--------------------------------

### Project Data Retrieval

Source: https://sprintra.io/docs/cli

Commands to list organizations, projects, features, stories, sprints, and decisions.

```bash
sprintra orgs
```

```bash
sprintra projects
```

```bash
sprintra features [--status <status>]
```

```bash
sprintra stories [--feature <id>] [--status <status>]
```

```bash
sprintra sprints
```

```bash
sprintra decisions
```

--------------------------------

### Generate standup report with /standup

Source: https://sprintra.io/docs/skills

Produces a summary of recent work sessions, commits, and story updates.

```text
/standup

Standup — March 23, 2026

Done (since last session)
- Auth middleware refactor — done (Authentication)
- Login endpoint tests — done (Authentication)

In Progress
- Password reset flow — in_progress (Authentication)

Next Up
- Checkout UI component — recommended by AI

Sprint Progress
Sprint 5: 10/14 stories (71%)
[==============      ] 71% complete
```

--------------------------------

### releases.create

Source: https://sprintra.io/docs/mcp-tools

Create a release milestone.

```APIDOC
## releases.create

### Description
Create a release milestone.

### Parameters
- **project_id** - Required
- **name** - Required
- **version** - Required
- **target_date** - Optional
- **description** - Optional
```

--------------------------------

### Configure Sprintra via MCP

Source: https://sprintra.io/docs/install

Manual configuration for any MCP-compliant client using the mcpServers JSON structure.

```json
{
  "mcpServers": {
    "sprintra": {
      "command": "npx",
      "args": ["@sprintra/mcp"],
      "env": { "SPRINTRA_TOKEN": "<your-token>" }
    }
  }
}
```

--------------------------------

### Configure project ID

Source: https://sprintra.io/docs/cli

Set the project ID via environment variable or command-line flag to avoid repeated input.

```bash
export SPRINTRA_PROJECT=proj-abc123
# or
sprintra context --project proj-abc123
```

--------------------------------

### projects

Source: https://sprintra.io/docs/mcp-tools

The projects tool allows for the creation, updating, resolution, and configuration of projects, which map to code repositories.

```APIDOC
## projects

### Description
Manage project lifecycles including creation, updates, and configuration. Each project maps to a code repository.

### Methods
- **create**: Create a new project linked to a repository. Parameters: name, description, tech_stack, repo_path.
- **update**: Update project details, status, or description. Parameters: project_id, name, description, status, tech_stack.
- **resolve**: Find a project by name or repo path. Parameters: name, repo_path.
- **generate_claude_md**: Generate a CLAUDE.md file for auto-routing. Parameters: project_id
```

--------------------------------

### /sprint-plan

Source: https://sprintra.io/docs/skills

Creates or reviews a sprint plan with AI recommendations.

```APIDOC
## /sprint-plan

### Description
Analyzes features, stories, and sprints to identify unassigned work and recommends sprint composition based on priority and dependencies.
```

--------------------------------

### End coding session with /wrap

Source: https://sprintra.io/docs/skills

Ends the current coding session and saves context for future resumption.

```text
/wrap

Session Wrapped

Duration: 2h 15m
Stories completed: 2
  - s-abc123: Auth middleware
  - s-def456: Login endpoint
Files changed: 8
Next steps: Implement password reset flow

Context saved — next session will auto-resume.
```

--------------------------------

### Manage Session Transcripts via CLI

Source: https://sprintra.io/docs/memory-layer

Commands for indexing, searching, and maintaining local session transcript files.

```bash
# One-time: scan your session history and build the index
sprintra transcript reindex

# List recent transcripts
sprintra transcript list --since 2026-04-01

# Keyword search across every session
sprintra transcript search "auth bug fix"

# Open the actual transcript file (no copy made)
sprintra transcript view <session-id>

# Disk usage / oldest / newest / retention
sprintra transcript status

# Manual prune (default cutoff: 90 days)
sprintra transcript prune --before 2026-01-01 --dry-run
```

--------------------------------

### Manage Conversation Transcripts via CLI

Source: https://sprintra.io/docs/getting-started

Commands for indexing, listing, searching, and checking the status of local conversation transcripts.

```bash
# One-time backfill (indexes every Claude Code session you've had)
sprintra transcript reindex

# List recent transcripts
sprintra transcript list --since 2026-04-01

# FTS5 keyword search across every session
sprintra transcript search "drizzle parameter binding"

# Disk usage / oldest / newest / retention policy
sprintra transcript status
```

--------------------------------

### Define a custom skill in SKILL.md

Source: https://sprintra.io/docs/skills

Create custom workflows by placing a SKILL.md file within the .claude/skills/ directory. The file requires frontmatter for metadata and markdown content for instructions.

```markdown
---
name: my-skill
description: A custom workflow for my team
argument-hint: "[args]"
---

# My Custom Skill

Instructions for Claude to follow when this
skill is triggered...

## Steps

1. Do something
2. Do something else
3. Show results
```

--------------------------------

### Set Sprintra API token

Source: https://sprintra.io/docs/install/cursor

Configures the required environment variable for authentication. Ensure this is added to your shell profile and Cursor is restarted.

```bash
export SPRINTRA_TOKEN="vp_your_token_here"
```

--------------------------------

### executions.log

Source: https://sprintra.io/docs/mcp-tools

Record an action the agent took.

```APIDOC
## executions.log

### Description
Record an action the agent took (channel + outcome + metrics).

### Parameters
- **channel** (string) - Required - (twitter|deploy|ci|shell|...)
- **action_type** (string) - Required
- **content_ref** (string) - Optional
- **external_link** (string) - Optional
- **metrics_json** (object) - Optional
- **exit_status** (integer) - Optional
```

--------------------------------

### Capture a feature idea

Source: https://sprintra.io/docs/skills

Use the /capture command to generate stories, acceptance criteria, and record technical decisions from a brief conversation.

```text
/capture user authentication system

Feature: User Authentication System (high)
Stories: 5 (13 SP)
  1. Set up auth middleware — 3 SP
  2. Login/register API endpoints — 3 SP
  3. Password reset flow — 2 SP
  4. Session management — 3 SP
  5. Auth UI components — 2 SP
Decisions: 1 recorded
Completeness: 85%
```

--------------------------------

### dependencies.add

Source: https://sprintra.io/docs/mcp-tools

Mark one feature as depending on another.

```APIDOC
## dependencies.add

### Description
Mark one feature as depending on another.

### Parameters
- **project_id** - Required
- **feature_id** - Required
- **depends_on_id** - Required
- **dep_type** - Optional
```

--------------------------------

### Record an architectural decision

Source: https://sprintra.io/docs/skills

Use the /decide command to create an ADR, including context, decision, and consequences.

```text
/decide use PostgreSQL for primary database

Decision recorded: Use PostgreSQL for primary database (dec-abc123)
Category: technology
Status: accepted
```

--------------------------------

### dependencies.remove

Source: https://sprintra.io/docs/mcp-tools

Remove a dependency link.

```APIDOC
## dependencies.remove

### Description
Remove a dependency link.

### Parameters
- **project_id** - Required
- **feature_id** - Required
- **depends_on_id** - Required
```

--------------------------------

### Configure MCP for Claude Code

Source: https://sprintra.io/docs/getting-started

Register the Sprintra MCP server by adding this configuration to your ~/.claude.json file.

```json
{
  "mcpServers": {
    "sprintra": {
      "command": "npx",
      "args": ["@sprintra/cli", "mcp"]
    }
  }
}
```

--------------------------------

### releases.generate_notes

Source: https://sprintra.io/docs/mcp-tools

Auto-generate release notes from completed features.

```APIDOC
## releases.generate_notes

### Description
Auto-generate release notes from completed features.

### Parameters
- **release_id** - Required
```

--------------------------------

### Test Connectivity

Source: https://sprintra.io/docs/install/codex

Use curl to verify network access to the Sprintra health endpoint.

```bash
curl https://api.sprintra.io/api/health
```

--------------------------------

### Format CLI output as JSON

Source: https://sprintra.io/docs/cli

Use the --format json flag to pipe output into tools like jq for machine-readable data extraction.

```bash
$ sprintra context --format json | jq '.current_sprint.name'
"Sprint 14 — Session Replay"

$ sprintra stories --status todo --format json | jq '.[].title'
"Implement webhook handler"
"Add rate limiting"
"Write integration tests"
```

--------------------------------

### features

Source: https://sprintra.io/docs/mcp-tools

Methods for creating, updating, and retrieving epic-level work items.

```APIDOC
## features

### create
- **Description**: Create an epic/feature with acceptance criteria.
- **Parameters**: project_id, title, description, priority, phase (optional), acceptance_criteria (optional)

### update
- **Description**: Update status, priority, or details of a feature.
- **Parameters**: feature_id, title (optional), status (optional), priority (optional), description (optional)

### get_bundle
- **Description**: Get feature with all stories and dependencies.
- **Parameters**: feature_id
```

--------------------------------

### search.query

Source: https://sprintra.io/docs/mcp-tools

Free-text search returning ranked matches with previews.

```APIDOC
## search.query

### Description
Free-text search returning ranked matches with previews.

### Parameters
- **query** (string) - Required
- **project_id** (string) - Required
- **entity_types** (array) - Optional
- **limit** (integer) - Optional
```

--------------------------------

### git

Source: https://sprintra.io/docs/mcp-tools

Methods for syncing git history, linking commits to features, and retrieving git-related statistics.

```APIDOC
## git

### sync_commits
- **Description**: Import recent git commits into Sprintra.
- **Parameters**: project_id, limit (optional)

### link_commits
- **Description**: Link commits to a feature by hash.
- **Parameters**: project_id, feature_id, commit_hashes[]

### unlink_commits
- **Description**: Remove commit-feature links.
- **Parameters**: project_id, commit_hashes[]

### get_status
- **Description**: Get current repo git status.
- **Parameters**: project_id

### get_feature_stats
- **Description**: Git stats per feature (commits, files, AI %).
- **Parameters**: project_id
```

--------------------------------

### Review sprint progress with /sprint-review

Source: https://sprintra.io/docs/skills

Generates a comprehensive review of sprint metrics, story delivery, and feature status.

```text
/sprint-review

Sprint Review: Sprint 5 — API Layer

Progress
10/14 stories (71%) | 28/38 SP delivered
[==============      ] 71% complete

By Status
- Done: 10 stories
- In Progress: 2 stories
- Todo: 2 stories

Feature Breakdown
| Feature        | Stories | Done | Status    |
|----------------|---------|------|-----------|
| Authentication | 5/5     | 5    | Complete  |
| Payments       | 3/5     | 3    | On Track  |
| Notifications  | 2/4     | 2    | At Risk   |
```

--------------------------------

### criteria.verify

Source: https://sprintra.io/docs/mcp-tools

AI-verify all criteria for a feature.

```APIDOC
## criteria.verify

### Description
AI-verify all criteria for a feature.

### Parameters
- **feature_id** - Required
```

--------------------------------

### Expected MCP Output

Source: https://sprintra.io/docs/install/codex

The expected output format when listing MCP servers.

```text
Name      Url                              Bearer Token Env Var  Status   Auth
sprintra  https://api.sprintra.io/api/mcp  SPRINTRA_TOKEN        enabled  Bearer token
```

--------------------------------

### executions.list

Source: https://sprintra.io/docs/mcp-tools

Query executions by channel, agent, status, or time window.

```APIDOC
## executions.list

### Description
Query executions by channel, agent, status, or time window.

### Parameters
- **project_id** (string) - Required
- **channel** (string) - Optional
- **agent_id** (string) - Optional
- **exit_status** (integer) - Optional
- **since** (string) - Optional
- **until** (string) - Optional
- **limit** (integer) - Optional
```

--------------------------------

### notes

Source: https://sprintra.io/docs/mcp-tools

Method for quick-capture of ideas and observations.

```APIDOC
## notes

### Methods
- **add**(project_id, content, tags?, feature_id?, source?): Quick-capture a note.
```

--------------------------------

### sprints

Source: https://sprintra.io/docs/mcp-tools

Methods for managing time-boxed iterations and assigning work items.

```APIDOC
## sprints

### create
- **Description**: Create a new sprint with goal and dates.
- **Parameters**: project_id, name, goal, start_date, end_date

### update
- **Description**: Update sprint status, goal, or dates.
- **Parameters**: sprint_id, name (optional), goal (optional), status (optional), start_date (optional), end_date (optional)

### assign
- **Description**: Assign a feature or story to a sprint.
- **Parameters**: sprint_id, feature_id (optional), story_id (optional)
```

--------------------------------

### work_sessions

Source: https://sprintra.io/docs/mcp-tools

Methods for tracking coding sessions to maintain an audit trail and session continuity.

```APIDOC
## work_sessions

### start
- **Description**: Start tracking a coding session.
- **Parameters**: project_id, goal (optional)

### end
- **Description**: End work session with summary.
- **Parameters**: session_id, summary, files_changed (optional), stories_completed (optional)

### get_active
- **Description**: Check for an active work session.
- **Parameters**: project_id
```

--------------------------------

### sessions

Source: https://sprintra.io/docs/mcp-tools

Methods for managing AI-powered brainstorm sessions with specific personas.

```APIDOC
## sessions

### start
- **Description**: Start a brainstorm session with a persona.
- **Parameters**: project_id, persona

### log_message
- **Description**: Log a message in the active session.
- **Parameters**: session_id, role, content

### complete
- **Description**: End session with summary and outcomes.
- **Parameters**: session_id, summary, decisions_made (optional), features_created (optional)
```

--------------------------------

### documents

Source: https://sprintra.io/docs/mcp-tools

Methods for managing versioned knowledge base documents such as PRDs and specifications.

```APIDOC
## documents

### Methods
- **create**(project_id, title, content, doc_type, template?, tags?): Create a KB document.
- **update**(document_id, title?, content?, status?): Update document content.
- **get**(document_id): Get full document with content.
- **get_versions**(document_id): List version history.
- **restore_version**(document_id, version): Restore a previous version.
```

--------------------------------

### stories

Source: https://sprintra.io/docs/mcp-tools

Methods for managing individual tasks and work items within features.

```APIDOC
## stories

### create
- **Description**: Create a task/story under a feature.
- **Parameters**: feature_id, title, description, type (story|task|bug|chore), story_points (optional)

### update
- **Description**: Update story status or details.
- **Parameters**: story_id, title (optional), status (optional), description (optional), story_points (optional)

### batch_update
- **Description**: Update multiple stories at once.
- **Parameters**: updates[] (array of story updates)
```

--------------------------------

### pull_requests.list

Source: https://sprintra.io/docs/mcp-tools

List pull requests for a project.

```APIDOC
## pull_requests.list

### Description
List pull requests for a project.

### Parameters
- **project_id** (string) - Required
- **status** (string) - Optional
```

--------------------------------

### releases.update

Source: https://sprintra.io/docs/mcp-tools

Update release details or status.

```APIDOC
## releases.update

### Description
Update release details or status.

### Parameters
- **release_id** - Required
- **name** - Optional
- **version** - Optional
- **status** - Optional
- **target_date** - Optional
```

--------------------------------

### /capture [idea]

Source: https://sprintra.io/docs/skills

Captures a feature idea, generates stories and acceptance criteria, and records technical decisions.

```APIDOC
## /capture [idea]

### Description
Captures a feature idea with stories, acceptance criteria, and decisions. It engages in a short conversation to generate a feature summary, break it into stories, and record technical decisions.

### Parameters
#### Path Parameters
- **idea** (string) - Required - The feature idea or topic to capture.
```

--------------------------------

### /decide [topic]

Source: https://sprintra.io/docs/skills

Records a technical or architecture decision as an ADR.

```APIDOC
## /decide [topic]

### Description
Records a technical or architecture decision as an ADR, including context, decision, and consequences. It checks for conflicts with existing decisions and discusses tradeoffs if options are compared.

### Parameters
#### Path Parameters
- **topic** (string) - Required - The technical or architecture topic for the decision.
```

--------------------------------

### ai

Source: https://sprintra.io/docs/mcp-tools

Methods for accessing AI-powered project intelligence and reporting.

```APIDOC
## ai

### get_next_work
- **Description**: Recommended next story to work on with context and readiness score.
- **Parameters**: project_id

### report_progress
- **Description**: Generate a progress report for the current sprint or project.
- **Parameters**: project_id

### get_guidance
- **Description**: Get AI-generated guidance for current project state.
- **Parameters**: project_id, topic (optional)

### generate_briefing
- **Description**: Compact project state summary optimized for AI context windows.
- **Parameters**: project_id
```

--------------------------------

### criteria.add

Source: https://sprintra.io/docs/mcp-tools

Add an acceptance criterion to a feature.

```APIDOC
## criteria.add

### Description
Add an acceptance criterion to a feature.

### Parameters
- **feature_id** - Required
- **description** - Required
- **category** - Optional
```

--------------------------------

### comments

Source: https://sprintra.io/docs/mcp-tools

Methods for managing threaded comments on project entities.

```APIDOC
## comments

### add
- **Description**: Add a comment to an entity.
- **Parameters**: entity_type, entity_id, content, author (optional)

### list
- **Description**: List comments on an entity.
- **Parameters**: entity_type, entity_id

### update
- **Description**: Edit a comment.
- **Parameters**: comment_id, content

### delete
- **Description**: Remove a comment.
- **Parameters**: comment_id
```

--------------------------------

### decisions

Source: https://sprintra.io/docs/mcp-tools

Methods for managing Architecture Decision Records (ADRs) to capture technical choices.

```APIDOC
## decisions

### Methods
- **add**(project_id, title, context, decision, consequences, category): Record a technical decision.
- **supersede**(decision_id, new_decision_id, rationale): Replace a decision with a newer one.
- **get_conflicts**(project_id): Find potentially conflicting decisions.
- **resolve_conflict**(project_id, conflict_id, resolution): Resolve a flagged conflict.
```

--------------------------------

### Configure Sprintra Memory Privacy

Source: https://sprintra.io/docs/memory-layer

Use these flags in your configuration file to disable specific data capture features or enforce strict local-only memory operations.

```json
# ~/.sprintra/config.json

{
  "capture_user_prompts":     false,   // disables prompt capture
  "capture_session_digests":  false,   // disables session summaries
  "capture_transcript_index": false,   // disables local indexing
  "strict_local_memory":      true     // blocks all memory-layer cloud calls
}
```

--------------------------------

### custom_fields

Source: https://sprintra.io/docs/mcp-tools

Methods for defining and managing custom metadata fields on entities.

```APIDOC
## custom_fields

### define
- **Description**: Define a custom field schema.
- **Parameters**: project_id, entity_type, field_name, field_type, options (optional)

### set
- **Description**: Set custom field values on an entity.
- **Parameters**: entity_type, entity_id, fields

### get
- **Description**: Get custom field values for an entity.
- **Parameters**: entity_type, entity_id
```

--------------------------------

### search.reindex

Source: https://sprintra.io/docs/mcp-tools

Backfill the search index from existing rows.

```APIDOC
## search.reindex

### Description
Backfill the search index from existing rows (one-time migration after enabling).

### Parameters
- **project_id** (string) - Required
```

--------------------------------

### executions.update_metrics

Source: https://sprintra.io/docs/mcp-tools

Patch metrics_json after the fact.

```APIDOC
## executions.update_metrics

### Description
Patch metrics_json after the fact (e.g. tweet engagement 24h later).

### Parameters
- **execution_id** (string) - Required
- **metrics_json** (object) - Required
```

--------------------------------

### criteria.remove

Source: https://sprintra.io/docs/mcp-tools

Remove a criterion.

```APIDOC
## criteria.remove

### Description
Remove a criterion.

### Parameters
- **feature_id** - Required
- **criterion_id** - Required
```

--------------------------------

### criteria.update_status

Source: https://sprintra.io/docs/mcp-tools

Mark criteria as met or not met.

```APIDOC
## criteria.update_status

### Description
Mark criteria as met or not met.

### Parameters
- **feature_id** - Required
- **criterion_id** - Required
- **status** - Required
```
Tokens:
Raw