list_inspiration_opportunities

mcp:readread-only

List saved inspiration items and the content opportunities found in them, across X and LinkedIn, best match first. Filter by platform, topic, analysis or opportunity status. Items are compact summaries (excerpt, topic, hook, why it matters, score breakdown, matched pillars, saved drafts); pass verbose: true only when you need the full source text and notes.

Returns { items, page, limit, total, hasMore }: limit is per page (default 50, max 100), page is 1-based; call again with page + 1 while hasMore is true.

Input

• platformstring

  one of x, linkedin

• topicstring

  max length 200

• hookstring

  max length 200

• audiencestring

  max length 200

• creatorstring

  max length 200

• tagstring

  max length 80

• analysisStatusstring

  one of pending, processing, ready, failed, skipped

• opportunityStatusstring

  one of open, saved, hidden, dismissed, acted_on

• includeHiddenboolean | string
• sortstring

  one of relevance, recent · default "relevance"

• savedFromstring (date-time)
• savedTostring (date-time)
• pageinteger

  1-based page number. Use with limit; hasMore says whether another page exists.

  min 1 · default 1

• limitinteger

  min 1 · max 100 · default 50

• verboseboolean | string

  Return full records (whole source text, notes, media, provider metadata). Off by default.

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_inspiration_opportunities",
    "arguments": {}
  }
}

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/inspiration as the signed-in user, with the same validation, approval rules and limits. See it in the Inspiration API reference.