> Discover all available Postdom documentation from the machine-readable index: https://postdom.com/llms.txt

Configured tool · read-only

# `get_learning`

Read shared account learning: source-linked observations and exploratory advice for one learning scope.

read-only · non-destructive · closed-world

Human and agent roles

## Configured boundary

### Configured workspace

Read-only. It does not apply advice, correct a brief, fund a job, approve a plan or publish. Private drafts are never returned.

This reference describes the hosted server at https://api.postdom.com/mcp, which runs current source, with a workspace-scoped key created under Connected apps → For developers. The published `@postdom/mcp@0.4.0` package has 14 of these tools: it lacks list_posts, create_slideshow, account_music and the media array.

Callable schema

## Input fields

Field names match the configured tool schema. Runtime-only constraints are labeled separately from schema validation.

| Field | Type | Contract |
| --- | --- | --- |
| scopeId Optional | uuid | Optional. Call get_learning with no arguments to read the default scope, or pass scopeId for one scope. |

**For AI agents:** Send only fields exposed by the current tool schema.

**Known failure:** Do not invent platform settings, account IDs, media fields, or setup steps.

Synthetic values

## Example call

Identifiers and values are examples. They do not represent a connected workspace or accepted media source.

_EXAMPLE CALL · CONFIGURED TOOL SCHEMA_

```
get_learning({})
```

Observed API record

## Return shape

Returns learning, or null when the scope has nothing saved. Inside learning: the scope, each observation with its source, and any exploratory advice with its validity.

**`learning.scope` (identity)** — Identifies what the observations are about.

**`learning.observations[]` (source-linked evidence[])** — Each observation carries the recorded measurement and the post or account it came from.

**`learning.advice` (exploratory advice)** — Advice is exploratory and may be invalidated later.

**`learning.advice.validity` (validity)** — Says whether advice still stands.

Stop conditions

## Agent handoff

`learning present`

### Read the numbers behind it

Read get_performance and get_best_posts for the numbers behind an observation.

`learning null`

### Read what a person wrote

Read get_brief for the guidance a person wrote.

 VERIFIED · 26 AUGUST 2026  **GET /v1/learning**

Examples are synthetic. Human workspace-key creation and revocation remain in Postdom under Connected apps → For developers.
