---
name: tracker/jira-official:board-read
description: Read board configuration
version: "0.5.0"
---

# Board Read

> **Backend:** jira-official (atlassian@claude-plugins-official)

> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

> **Plugin Support:** This operation may not be supported by the official Atlassian plugin. If unavailable, use the Atlassian REST API directly or switch to a custom backend with `TRACKER_BACKEND_OVERRIDE: jira-custom`.

Retrieves configuration and metadata for a JIRA board by its ID.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| board_id | number | Yes | JIRA board ID |

## Implementation

Board read is not exposed as a direct tool in the official Atlassian plugin. Use the JIRA REST API directly as a fallback:

```
# Get board configuration — JIRA REST API fallback
GET /rest/agile/1.0/board/<board_id>
```

To list all visible boards for a project, use `mcp__atlassian__getVisibleJiraProjects` to confirm the project exists, then query the JIRA REST API:

```
mcp__atlassian__getVisibleJiraProjects()

# Then fetch boards via REST
GET /rest/agile/1.0/board?projectKeyOrId=<project_key>
```

If the plugin gains native board read tools, the expected tool name would follow the pattern `mcp__atlassian__getJiraBoard`.

## Output

| Field | Type | Description |
|-------|------|-------------|
| id | number | Board ID |
| name | string | Board display name |
| type | string | Board type (`scrum` or `kanban`) |
| location | object | Project key and name the board belongs to |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Board ID not found | Verify the board ID in JIRA project settings |
| 403 | Insufficient permissions to view the board | Confirm the JIRA user has browse permissions on the project |
| 400 | Invalid board ID format | Board ID must be a positive integer |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- design-feature (reading board configuration before sprint planning)
