> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # Check whether your tasks in a project can start > Lists the required MCP servers the project enables, and those its repository's .mcp.json and .codex/config.toml declare at base_branch, that creating a task there would be refused for (mcp_server_not_connected): those whose connection its credential policy names — yours for the creator policy, the organization's for the org policy — does not exist or needs reauthorization. Task creation runs the same check. Empty when your tasks can start. A repository file a task cannot use is refused (mcp_repo_config_invalid). ## OpenAPI ````yaml api-reference/openapi.v1.json GET /projects/{id}/mcp-server-readiness openapi: 3.1.0 info: title: Aether Public API version: 0.1.0 description: >- The versioned, public Aether REST API. Authenticate with an `aether_` platform API key or a session token. servers: - url: https://api.runaether.dev/v1 security: - bearerAuth: [] paths: /projects/{id}/mcp-server-readiness: get: tags: - mcp-servers summary: Check whether your tasks in a project can start description: >- Lists the required MCP servers the project enables, and those its repository's .mcp.json and .codex/config.toml declare at base_branch, that creating a task there would be refused for (mcp_server_not_connected): those whose connection its credential policy names — yours for the creator policy, the organization's for the org policy — does not exist or needs reauthorization. Task creation runs the same check. Empty when your tasks can start. A repository file a task cannot use is refused (mcp_repo_config_invalid). operationId: getProjectMcpServerReadiness parameters: - in: path name: id required: true schema: format: uuid type: string - description: >- The branch the task would be based on, whose .mcp.json and .codex/config.toml are checked; the project's default branch when omitted. explode: false in: query name: base_branch schema: description: >- The branch the task would be based on, whose .mcp.json and .codex/config.toml are checked; the project's default branch when omitted. type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ProjectMcpServerReadinessResponse' description: OK '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error components: schemas: ProjectMcpServerReadinessResponse: additionalProperties: false properties: optional_servers: description: >- The optional servers of the project's catalog and of the plugins it enables that the viewer's tasks start without, since their connection cannot be used: a task is created, and its agent is not given them. Ordered by key; empty when none. Never a server the task's repository declares. items: $ref: '#/components/schemas/McpServerNotConnected' type: array repo_mcp_server_skips: description: >- The declarations of the repository's .mcp.json and .codex/config.toml the viewer's tasks start without, since Aether cannot use them, in the order found; empty when none. items: $ref: '#/components/schemas/RepoMcpServerSkip' type: array servers: description: >- The required servers task creation refuses the viewer's tasks for (mcp_server_not_connected), ordered by key; empty when none. items: $ref: '#/components/schemas/McpServerNotConnected' type: array required: - servers - optional_servers - repo_mcp_server_skips type: object ErrorResponse: additionalProperties: false properties: code: type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting type: string error: minLength: 1 type: string required: - error - code type: object McpServerNotConnected: additionalProperties: false properties: display_name: type: string key: type: string policy: enum: - creator - org type: string reason: enum: - not_connected - needs_reauth type: string repo: $ref: '#/components/schemas/McpServerRepoDeclaration' required: - key - display_name - policy - reason type: object RepoMcpServerSkip: additionalProperties: false properties: file: enum: - .mcp.json - .codex/config.toml type: string reason: description: Why the task is not given it, end-user copy. minLength: 1 type: string server: description: >- The server as the file names it; null when the whole file is skipped. minLength: 1 type: - string - 'null' required: - file - server - reason type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object McpServerRepoDeclaration: additionalProperties: false properties: cataloged: type: boolean file: enum: - .mcp.json - .codex/config.toml type: string required: - file - cataloged type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.