Tools

​

Core Tools

​

get_workspaces

Retrieves workspace information including id, title, and configuration. Parameters:

• workspace_ids (array of integers, optional)
• global (boolean, optional)

​

get_fields

Retrieves field metadata for workspaces including filter options, sort options, and field types. Parameters:

• workspace_ids (array of integers, optional)

​

Workspace Data

​

get_workspace_analytics

Retrieves analytics for workspaces including volume over time, tags, authors, domains, and narratives. Parameters:

• workspace_id (integer, required)
• since (float, optional, defaults to 90 days ago)
• to (float, optional, defaults to now)
• filters (object, optional)

​

search_workspace_mentions

Searches mentions within a workspace with filtering, sorting, and pagination. Parameters:

• workspace_id (integer, required)
• offset (integer, optional, defaults to 0)
• limit (integer, optional, defaults to 20)
• sort (object, optional)
• filters (object, optional)

​

get_top_social_accounts

Retrieves top social accounts by mention count for a workspace. Parameters:

• workspace_id (integer, required)
• sort (enum, optional)
• sort_direction (enum, optional)
• from (integer, optional)
• filters (object, optional)
• since (float, optional, defaults to 90 days ago)
• to (float, optional, defaults to now)
• size (integer, optional)

​

get_social_account

Retrieves detailed information about a social account including analytics and mentions. Parameters:

• account_id (string, required)

​

get_top_journalists

Retrieves top journalists by mention count for a workspace. Parameters:

• workspace_id (integer, required)
• filters (object, optional)
• since (float, optional, defaults to 90 days ago)
• to (float, optional, defaults to now)

​

get_custom_summary_prompts

Retrieves custom summary prompts configured for workspaces. Parameters:

• workspace_id (integer, required)

​

Narratives

​

search_narratives

Searches narratives within workspaces with filtering, sorting, and threat scoring. Parameters:

• workspace_ids (array of integers, optional)
• offset (integer, optional, defaults to 0)
• limit (integer, optional, defaults to 20)
• sort (string, optional)
• narrative_sort (string, optional)
• layer (integer, optional)
• analytics (array, optional)

​

get_narrative_volume_over_time

Retrieves volume over time data for narratives within a workspace.

​

get_narrative_mentions

Retrieves mentions associated with specific narratives. Parameters:

• workspace_ids (array of integers, optional)
• narrative_ids (array of integers, optional)
• filters (object, optional)
• sort (string, optional)
• offset (integer, optional, defaults to 0)
• limit (integer, optional, defaults to 20)
• since (float, optional, defaults to 90 days ago)
• to (float, optional, defaults to now)