read
Fetch a single topic in full, including YAML frontmatter, using its ID. Provides clear errors for missing topics; expired topics are still accessible by ID.
Instructions
Read a single topic in full, including its YAML frontmatter.
Errors with a clear message if the topic does not exist; call discover_topics first. Expired topics are still readable by id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"topic_id": "<topic_id>"
},
"name": "read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic_id | Yes | Topic id, e.g. 'projects/atlas-ports' |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |