delete_state
Delete a project state by providing its unique state ID and project ID.
Instructions
Delete a state by ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | UUID of the project | |
| state_id | Yes | UUID of the state |
Implementation Reference
- plane_mcp/tools/states.py:167-177 (handler)Handler function that deletes a state by project_id and state_id, using PlaneClient.states.delete()
@mcp.tool() def delete_state(project_id: str, state_id: str) -> None: """ Delete a state by ID. Args: project_id: UUID of the project state_id: UUID of the state """ client, workspace_slug = get_plane_client_context() client.states.delete(workspace_slug=workspace_slug, project_id=project_id, state_id=state_id) - plane_mcp/tools/__init__.py:45-45 (registration)Registration of state tools (including delete_state) via register_state_tools
register_state_tools(mcp) - plane_mcp/tools/states.py:17-17 (registration)register_state_tools wraps all state tools including delete_state with @mcp.tool() decorator
def register_state_tools(mcp: FastMCP) -> None: - plane_mcp/client.py:21-74 (helper)Helper that provides authenticated PlaneClient and workspace slug used by delete_state handler
def get_plane_client_context() -> PlaneClientContext: """ Initialize and return a PlaneClient instance with workspace context. Authentication is handled by the PlaneOAuthProvider, which supports: 1. Environment variables (PLANE_API_KEY + PLANE_WORKSPACE_SLUG) 2. HTTP headers (x-api-key + x-workspace-slug) 3. OAuth access token Environment variables: - PLANE_INTERNAL_BASE_URL: Internal URL for Plane API (preferred for server-to-server calls) - PLANE_BASE_URL: Base URL for Plane API (fallback, default: https://api.plane.so) Returns: PlaneClientContext containing configured PlaneClient instance and workspace slug Raises: ConfigurationError: If access token is not available or workspace slug is missing """ base_url = os.getenv("PLANE_INTERNAL_BASE_URL") or os.getenv("PLANE_BASE_URL", "https://api.plane.so") workspace_slug = os.getenv("PLANE_WORKSPACE_SLUG", "") api_key = os.getenv("PLANE_API_KEY", "") access_token = None # Get access token from the OAuth provider (which handles all auth methods) stored_access_token: AccessToken | None = get_access_token() if stored_access_token: # Determine authentication method to use appropriate PlaneClient constructor auth_method = stored_access_token.claims.get("auth_method", "oauth") token = stored_access_token.token workspace_slug = stored_access_token.claims.get("workspace_slug", "") # For API key auth methods, use api_key parameter; for OAuth, use access_token if auth_method in ("api_key_env", "api_key_header"): api_key = token else: access_token = token if access_token: client = PlaneClient( base_url=base_url, access_token=access_token, ) else: client = PlaneClient( base_url=base_url, api_key=api_key, ) return PlaneClientContext( client=client, workspace_slug=workspace_slug, ) - tests/test_integration.py:277-277 (helper)Integration test expected tools list includes delete_state to validate it is registered
"delete_state",