> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seesaw.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools overview

> The 14 SeeSaw tools and when to use which

Ten tools read **public data**; four read the **key owner's account**. Tool
results carry the same JSON as the corresponding REST endpoint (linked in
each page).

## Discover topics

| Tool                                        | Use when                                                  |
| ------------------------------------------- | --------------------------------------------------------- |
| [`search_topics`](/mcp/tools/search-topics) | You have a **keyword** ("bitcoin", "World Cup final")     |
| [`list_topics`](/mcp/tools/list-topics)     | You want a **ranking** — trending, newest, or ending soon |

## Inspect one topic

| Tool                                                            | Returns                                                               |
| --------------------------------------------------------------- | --------------------------------------------------------------------- |
| [`get_topic`](/mcp/tools/get-topic)                             | Full detail: description, options with probabilities or votes, volume |
| [`get_topic_price_history`](/mcp/tools/get-topic-price-history) | Probability time series (prediction markets only)                     |
| [`list_topic_comments`](/mcp/tools/list-topic-comments)         | Discussion, with each author's position when they hold one            |

## People and competition

| Tool                                              | Returns                                 |
| ------------------------------------------------- | --------------------------------------- |
| [`get_user`](/mcp/tools/get-user)                 | Public profile + track record by handle |
| [`list_user_topics`](/mcp/tools/list-user-topics) | Topics a user created (privacy-gated)   |
| [`get_leaderboard`](/mcp/tools/get-leaderboard)   | Global / zone / contest boards          |
| [`list_zones`](/mcp/tools/list-zones)             | Topic communities with counts           |
| [`get_contest`](/mcp/tools/get-contest)           | World Cup pick'em schedule and results  |

## The key owner's account

| Tool                                                    | Returns                                                   |
| ------------------------------------------------------- | --------------------------------------------------------- |
| [`get_my_profile`](/mcp/tools/get-my-profile)           | Own profile **including** credits, diamonds, total assets |
| [`list_my_positions`](/mcp/tools/list-my-positions)     | Open positions with cost, current price, unrealized P\&L  |
| [`list_my_settlements`](/mcp/tools/list-my-settlements) | Settled outcomes: payouts, claim status, realized P\&L    |
| [`list_my_topics`](/mcp/tools/list-my-topics)           | Own created topics, incl. moderation status               |

<Note>
  Financial fields exist **only** on `get_my_profile` and the other `*_my_*`
  tools — public profiles never expose another user's balance.
</Note>

## Typical combinations

* *"What does the market think about X?"* — `search_topics` →
  `get_topic` → `get_topic_price_history`.
* *"Summarize the debate"* — `get_topic` → `list_topic_comments` (positions
  attached make sentiment analysis easy).
* *"How is my portfolio doing?"* — `get_my_profile` → `list_my_positions` →
  `list_my_settlements`.
* *"Who should I follow?"* — `get_leaderboard` → `get_user` →
  `list_user_topics`.