AgilePlus

Appearance

MCP Tools Catalog ​

AgilePlus exposes capabilities as Model Context Protocol (MCP) tools, implemented in the agileplus-mcp server. This allows AI agents to interact with the entire feature lifecycle programmatically.

Tool Categories ​

Feature Specification Tools ​

agileplus_get_feature ​

Retrieve full details of a feature.

json
{
  "name": "agileplus_get_feature",
  "description": "Get feature details by slug",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Feature slug (e.g., '001-user-login')"
      }
    },
    "required": ["slug"]
  }
}

Returns:

json
{
  "id": 1,
  "slug": "001-user-login",
  "friendly_name": "User Login System",
  "state": "IMPLEMENT",
  "target_branch": "main",
  "created_at": "2025-01-15T10:30:00Z",
  "wp_count": 3,
  "wp_done": 1
}

agileplus_list_features ​

List all features, optionally filtered by state.

json
{
  "name": "agileplus_list_features",
  "description": "List all features",
  "inputSchema": {
    "type": "object",
    "properties": {
      "state_filter": {
        "type": "string",
        "enum": ["SPECIFY", "PLAN", "IMPLEMENT", "REVIEW", "DONE"],
        "description": "Optional state filter"
      }
    }
  }
}

Work Package Tools ​

agileplus_list_work_packages ​

List all work packages for a feature.

json
{
  "name": "agileplus_list_work_packages",
  "description": "List work packages for a feature",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": {
        "type": "string",
        "description": "Feature slug"
      },
      "state_filter": {
        "type": "string",
        "enum": ["PLANNED", "DOING", "FOR_REVIEW", "DONE"],
        "description": "Optional state filter"
      }
    },
    "required": ["feature_slug"]
  }
}

Returns array of:

json
{
  "id": 5,
  "title": "Implement login form",
  "state": "DOING",
  "sequence": 1,
  "agent_id": "claude-code",
  "pr_url": "https://github.com/org/repo/pull/42",
  "pr_state": "draft",
  "depends_on": [],
  "file_scope": ["src/auth/login.rs", "src/auth/session.rs"]
}

agileplus_get_work_package_status ​

Get detailed status of a single work package.

json
{
  "name": "agileplus_get_work_package_status",
  "description": "Get work package status and metadata",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": { "type": "string" },
      "wp_sequence": { "type": "integer", "description": "WP number (1, 2, 3...)" }
    },
    "required": ["feature_slug", "wp_sequence"]
  }
}

Governance & Audit Tools ​

agileplus_check_governance_gate ​

Validate whether a feature can transition to a new state.

json
{
  "name": "agileplus_check_governance_gate",
  "description": "Check if a feature can transition to a new state",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": { "type": "string" },
      "transition": {
        "type": "string",
        "enum": ["PLAN", "IMPLEMENT", "REVIEW", "DONE"],
        "description": "Target state"
      }
    },
    "required": ["feature_slug", "transition"]
  }
}

Returns:

json
{
  "passed": false,
  "violations": [
    {
      "rule_id": "FR-REVIEW-001",
      "message": "At least one approved review required",
      "remediation": "Request code review from a reviewer"
    }
  ]
}

agileplus_get_audit_trail ​

Retrieve the audit trail for a feature (immutable changelog).

json
{
  "name": "agileplus_get_audit_trail",
  "description": "Get immutable audit trail for a feature",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": { "type": "string" },
      "after_id": {
        "type": "integer",
        "description": "Start from audit entry ID (for pagination)"
      }
    },
    "required": ["feature_slug"]
  }
}

Returns array of:

json
{
  "id": 42,
  "feature_slug": "001-login",
  "wp_sequence": 1,
  "timestamp": "2025-01-16T14:22:00Z",
  "actor": "claude-code",
  "transition": "DOING -> FOR_REVIEW",
  "evidence_refs": ["pr/42", "commit/abc123"],
  "hash": "sha256:..."
}

Command Dispatch ​

agileplus_dispatch_command ​

Execute arbitrary subcommands on the system.

json
{
  "name": "agileplus_dispatch_command",
  "description": "Execute a subcommand",
  "inputSchema": {
    "type": "object",
    "properties": {
      "command": {
        "type": "string",
        "description": "Command name (e.g., 'branch:create', 'commit:create')"
      },
      "feature_slug": { "type": "string" },
      "args": {
        "type": "object",
        "additionalProperties": { "type": "string" },
        "description": "Command arguments as key-value pairs"
      }
    },
    "required": ["command"]
  }
}

Example: Create a branch

json
{
  "command": "branch:create",
  "feature_slug": "001-login",
  "args": {
    "branch_name": "feat/001-login-WP01",
    "base": "main"
  }
}

Response:

json
{
  "success": true,
  "message": "Branch created: feat/001-login-WP01",
  "outputs": {
    "branch_ref": "refs/heads/feat/001-login-WP01"
  }
}

MCP Server Configuration ​

Claude Code Integration ​

json
{
  "mcpServers": {
    "agileplus": {
      "command": "agileplus",
      "args": ["mcp", "serve"],
      "env": {
        "AGILEPLUS_PROJECT": "/path/to/project",
        "AGILEPLUS_GRPC_HOST": "127.0.0.1",
        "AGILEPLUS_GRPC_PORT": "50051"
      }
    }
  }
}

Cursor Integration ​

json
{
  "tools": [
    {
      "name": "agileplus",
      "enabled": true,
      "command": "agileplus mcp serve",
      "timeout": 30,
      "env": {
        "AGILEPLUS_PROJECT": "${workspaceFolder}"
      }
    }
  ]
}

Tool Invocation Examples ​

Python Example ​

python
import subprocess
import json

# Call the MCP tool via stdio
proc = subprocess.Popen(
    ["agileplus", "mcp", "serve"],
    stdin=subprocess.PIPE,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    env={"AGILEPLUS_PROJECT": "/path/to/project"}
)

# Send JSON-RPC request
request = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "agileplus_get_feature",
        "arguments": {"slug": "001-login"}
    }
}

proc.stdin.write(json.dumps(request).encode() + b"\n")
response = json.loads(proc.stdout.readline().decode())
print(response)

Bash Example ​

bash
export AGILEPLUS_PROJECT="/path/to/project"

# Call a tool via JSON-RPC over stdio
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"agileplus_list_features"}}' \
  | agileplus mcp serve

Error Responses ​

MCP tools return standardized error responses:

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request",
    "data": {
      "reason": "Feature not found",
      "slug": "nonexistent"
    }
  }
}

Common error codes:

  • -32600: Invalid request (bad tool name, missing args)
  • -32601: Method not found (unknown command)
  • -32602: Invalid params (missing required field)
  • -32700: Parse error (malformed JSON)
  • -1: Internal error (storage/VCS failure)

Additional Tool Catalog ​

Transition Tools ​

agileplus_transition_feature ​

Trigger a feature state transition (subject to governance checks).

json
{
  "name": "agileplus_transition_feature",
  "description": "Transition a feature to a new state",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": { "type": "string" },
      "target_state": {
        "type": "string",
        "enum": ["Specified", "Researched", "Planned", "Implementing", "Validated", "Shipped", "Cancelled"]
      },
      "actor": {
        "type": "string",
        "description": "Actor identifier: 'human:alice' or 'agent:claude-code'"
      },
      "evidence": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "fr_id": { "type": "string" },
            "evidence_type": { "type": "string" },
            "artifact_path": { "type": "string" }
          }
        }
      }
    },
    "required": ["feature_slug", "target_state", "actor"]
  }
}

Returns:

json
{
  "success": true,
  "new_state": "Planned",
  "audit_entry_id": 5,
  "audit_hash": "sha256:0x9c0d...",
  "governance_checks_passed": 3,
  "timestamp": "2026-03-01T16:00:00Z"
}

agileplus_transition_work_package ​

Transition a work package state.

json
{
  "name": "agileplus_transition_work_package",
  "description": "Transition a work package state",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": { "type": "string" },
      "wp_id": { "type": "string" },
      "target_state": {
        "type": "string",
        "enum": ["Planned", "Doing", "ForReview", "Done", "Blocked"]
      },
      "actor": { "type": "string" },
      "block_reason": {
        "type": "string",
        "description": "Required when target_state is Blocked"
      }
    },
    "required": ["feature_slug", "wp_id", "target_state", "actor"]
  }
}

Artifact Tools ​

agileplus_read_artifact ​

Read a text artifact from the feature's artifact store.

json
{
  "name": "agileplus_read_artifact",
  "description": "Read a feature artifact (spec.md, plan.md, research.md, etc.)",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": { "type": "string" },
      "relative_path": {
        "type": "string",
        "description": "Path relative to feature dir: 'spec.md', 'WP01/prompt.md'"
      }
    },
    "required": ["feature_slug", "relative_path"]
  }
}

Returns:

json
{
  "content": "# User Authentication\n\n## Functional Requirements...",
  "size_bytes": 2147,
  "sha256": "0x3f7e..."
}

agileplus_write_artifact ​

Write or update a feature artifact.

json
{
  "name": "agileplus_write_artifact",
  "description": "Write content to a feature artifact",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": { "type": "string" },
      "relative_path": { "type": "string" },
      "content": { "type": "string" },
      "commit_message": {
        "type": "string",
        "description": "Git commit message for this artifact write"
      }
    },
    "required": ["feature_slug", "relative_path", "content"]
  }
}

Sync Tools ​

agileplus_sync_push ​

Push AgilePlus state to external trackers.

json
{
  "name": "agileplus_sync_push",
  "description": "Push feature/WP state to Plane.so or GitHub",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feature_slug": {
        "type": "string",
        "description": "Optional: sync only this feature. Omit for all."
      },
      "platform": {
        "type": "string",
        "enum": ["plane", "github", "all"],
        "default": "all"
      },
      "dry_run": {
        "type": "boolean",
        "description": "If true, simulate without making changes"
      }
    }
  }
}

Returns:

json
{
  "pushed_features": 3,
  "pushed_wps": 12,
  "created_issues": 5,
  "updated_issues": 7,
  "conflicts_detected": 0,
  "duration_ms": 1240
}

agileplus_sync_status ​

Get current sync status and last sync time.

json
{
  "name": "agileplus_sync_status",
  "description": "Get sync status with external trackers",
  "inputSchema": {
    "type": "object",
    "properties": {
      "platform": {
        "type": "string",
        "enum": ["plane", "github", "all"]
      }
    }
  }
}

Returns:

json
{
  "platforms": {
    "plane": {
      "connected": true,
      "last_sync": "2026-03-01T15:55:00Z",
      "pending_pushes": 2,
      "pending_pulls": 0
    },
    "github": {
      "connected": true,
      "last_sync": "2026-03-01T15:50:00Z",
      "pending_pushes": 0,
      "pending_pulls": 1
    }
  }
}

Full Tool Inventory ​

ToolCategoryDescription
agileplus_get_featureFeaturesGet feature details
agileplus_list_featuresFeaturesList features, filtered by state
agileplus_transition_featureFeaturesTrigger state transition
agileplus_list_work_packagesWPsList WPs for a feature
agileplus_get_work_package_statusWPsGet WP detail
agileplus_transition_work_packageWPsTransition WP state
agileplus_check_governance_gateGovernanceCheck if transition is allowed
agileplus_get_audit_trailAuditGet immutable audit log
agileplus_verify_audit_chainAuditVerify hash chain integrity
agileplus_read_artifactArtifactsRead spec, plan, etc.
agileplus_write_artifactArtifactsWrite artifact content
agileplus_sync_pushSyncPush to external trackers
agileplus_sync_pullSyncPull from external trackers
agileplus_sync_statusSyncGet sync health
agileplus_dispatch_commandCommandsExecute agent subcommands

Next Steps ​

MIT License

© 2025 Phenotype