Choose MCP tools

SocQ supports a compact toolset for open-ended research and typed tools for known platforms or endpoints. Filtering controls which tool schemas your client loads, reducing context usage and making tool selection more predictable.

Choose a mode

Mode	Tools loaded	Best for	Invocation shape
Compact	Seven discovery, execution, task, file, and account tools	Exploration and cross-platform requests	`socq_execute` with nested `input`
Platform	Typed collection tools for up to five platforms, plus task, file, and account tools	Work limited to known platforms	Direct typed tool with flat arguments
Exact tools	Up to thirty selected collection tools, plus task, file, and account tools	Stable production workflows	Direct typed tool with flat arguments

If you are unsure which endpoint to use, start with compact mode. If your application always collects the same resource, use an exact-tool connection.

Compact mode

Connect to:

https://api.socq.ai/mcp

The client discovers an endpoint and submits it through socq_execute:

{
  "endpoint": "youtube/comments",
  "input": {
    "urls": ["https://www.youtube.com/watch?v=VIDEO_ID"],
    "results_limit": 100,
    "sort_by": "newest"
  },
  "wait_seconds": 30,
  "result_limit": 25
}

Use this mode when the client needs socq_search_endpoints and socq_describe_endpoint to choose among many capabilities.

Platform mode

Select one to five comma-separated platform slugs:

https://api.socq.ai/mcp?platforms=youtube,tiktok

This exposes typed tools such as:

socq_youtube_comments
socq_youtube_search
socq_tiktok_profiles
socq_tiktok_videos

Platform slugs match the first segment of the API path, for example youtube, tiktok, and facebook-ad-library.

Exact-tool mode

Select one to thirty comma-separated tool identifiers without the socq_ prefix:

https://api.socq.ai/mcp?tools=youtube_comments,x_search

For tools=youtube_comments, the connection exposes:

socq_youtube_comments
socq_get_task
socq_get_files
socq_account

Call the typed tool with API input fields directly:

{
  "urls": ["https://www.youtube.com/watch?v=VIDEO_ID"],
  "results_limit": 100,
  "sort_by": "newest",
  "_wait_seconds": 30,
  "_result_limit": 25
}

Typed tools add three optional control fields:

Field	Purpose
`_wait_seconds`	Wait up to 30 seconds before returning the task
`_result_limit`	Limit normalized records returned with this response, from 1 to 100
`_idempotency_key`	Make a retry return the original task instead of creating another one

These are separate from business inputs such as results_limit. For example, results_limit: 100 requests up to 100 collected comments, while _result_limit: 25 limits the current response page to 25 records.

Naming rules

The mapping is deterministic:

REST path	Endpoint ID	Typed tool	Filter identifier
`/v1/youtube/comments`	`youtube/comments`	`socq_youtube_comments`	`youtube_comments`
`/v1/x/search`	`x/search`	`socq_x_search`	`x_search`
`/v1/facebook-ad-library/ad`	`facebook-ad-library/ad`	`socq_facebook_ad_library_ad`	`facebook_ad_library_ad`

Restrictions

platforms and tools cannot be combined in the same URL.
Platform mode accepts at most five platforms.
Exact-tool mode accepts at most thirty tools.
Filtering changes tool visibility only. Authentication, product availability, billing, API-key limits, and asynchronous task behavior remain unchanged.
Reconnect or restart the client after changing a filter so it refreshes tools/list.

To verify a filtered connection, ask the client to list its SocQ tools, then run one small collection and confirm that socq_get_task can read the returned task ID.

Get started

Clients

Workflows

Choose MCP tools

Choose MCP tools

Choose a mode

Compact mode

Platform mode

Exact-tool mode

Naming rules

Restrictions

​Choose MCP tools

​Choose a mode

​Compact mode

​Platform mode

​Exact-tool mode

​Naming rules

​Restrictions

Choose MCP tools

Choose a mode

Compact mode

Platform mode

Exact-tool mode

Naming rules

Restrictions