API Reference

Connect your IDE using the https://www.clwsmth.com/api/mcp endpoint. Your IDE handles the protocol automatically.

Authentication

Include your API key in every request header:

HEADER

Authorization: Bearer clwsmth_your_publicid_your_secret

Missing or invalid key returns HTTP 401. Inactive subscriptions return HTTP 403.

Data Tools

get_signals

List signals from the OpenClaw ecosystem. Sorted by virality score descending.

INPUTS

typestringFilter by signal type: issue | hype | revenue | trend

tagstringFilter by topic tag (e.g. 'workspace')

limitstringMax results. Default 20, max 100.

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_signals",
    "arguments": { "type": "issue", "limit": "10" }
  }
}

get_signal

Get a single signal with all related data: sources, solutions, FAQs, trends, and score history.

INPUTS

slugstringSignal slug

idstringSignal UUID

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_signal",
    "arguments": { "slug": "openclaw-workspace-migration" }
  }
}

get_leads

Get warm leads for a signal, sorted by engagement score. Returns builders, complainers, users, investors, and competitors.

INPUTS

signal_id*stringSignal UUID

limitstringMax results. Default 20.

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_leads",
    "arguments": { "signal_id": "uuid-here", "lead_type": "builder" }
  }
}

get_idea

Get a full product idea brief including features, issues solved, competitive landscape, revenue proof, and notable voices.

INPUTS

signal_idstringSignal UUID. Returns the first linked idea

idea_slugstringIdea slug

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_idea",
    "arguments": { "idea_slug": "workspace-migration-tool" }
  }
}

get_competitors

Get existing solutions and competitors for a signal.

INPUTS

signal_id*stringSignal UUID

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_competitors",
    "arguments": { "signal_id": "uuid-here" }
  }
}

get_keywords

Get keywords with interest score and trend direction.

INPUTS

signal_idstringFilter by signal UUID

trend_directionstringFilter: rising | stable | falling

JSON

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

get_sources

Get raw source posts and links that contributed to a signal.

INPUTS

signal_id*stringSignal UUID

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_sources",
    "arguments": { "signal_id": "uuid-here" }
  }
}

get_faqs

Get FAQ items for a signal (used for SEO and context).

INPUTS

signal_id*stringSignal UUID

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_faqs",
    "arguments": { "signal_id": "uuid-here" }
  }
}

get_score_history

Get the virality score history for a signal over time.

INPUTS

signal_id*stringSignal UUID

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_score_history",
    "arguments": { "signal_id": "uuid-here" }
  }
}

get_trends

Get trend data for a signal (search volume, engagement, sentiment over time).

INPUTS

signal_id*stringSignal UUID

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_trends",
    "arguments": { "signal_id": "uuid-here" }
  }
}

get_topics

List all OpenClaw topics/categories sorted by total engagement.

JSON

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

search_signals

Full-text search across signal titles, summaries, and gap descriptions.

INPUTS

query*stringSearch query string

limitstringMax results. Default 10, max 50.

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_signals",
    "arguments": { "query": "workspace migration" }
  }
}

Prompt Tools

These tools return formatted markdown rather than raw JSON, designed to be passed directly to your agent as context.

get_product_brief

Generate an agent-ready PM product brief in markdown. Includes features with coding prompts, issues solved, competitive landscape, and revenue proof.

INPUTS

idea_idstringIdea UUID

idea_slugstringIdea slug (alternative to idea_id)

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_product_brief",
    "arguments": { "idea_slug": "workspace-migration-tool" }
  }
}

get_distribution

Generate a distribution playbook with notable voices and warm leads grouped by platform.

INPUTS

idea_idstringIdea UUID

idea_slugstringIdea slug (alternative to idea_id)

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_distribution",
    "arguments": { "idea_slug": "workspace-migration-tool" }
  }
}