MCP-Tools - Overview

Access Permissions

MCP tools are divided into two groups:

Read Tools — require only read scope; work with any token or OAuth connection that has read permissions
Write Tools — require write scope; require an admin token or an OAuth connection with write permissions

Read Tools

`search_updates`

Searches updates for search terms, sources, tags, and time periods.

Parameter	Type	Description
`query`	String	Full-text search term (optional)
`source_id`	String	Updates from a specific source (optional)
`tags`	Array	Update tags to filter by (optional)
`folder`	String	`inbox`, `saved`, or `dropped` (optional)
`limit`	Integer	Number of results (default: 20, max: 100)

`get_update_details`

Returns the complete content of a single update.

Parameter	Type	Description
`update_id`	String	ID of the update

`list_sources`

Lists all sources in the workspace.

Parameter	Type	Description
`active_only`	Boolean	Return only active sources (default: true)

`list_reports`

Lists available AI reports.

Parameter	Type	Description
`type`	String	`summary`, `feedback`, `list`, `linkedin_post`, `conversation_starters` (optional)
`limit`	Integer	Number (default: 10)

`get_report`

Returns the complete content of a report.

Parameter	Type	Description
`report_id`	String	Report ID

`get_team_context`

Returns the AI context of the workspace (website URL and context documents).

No parameters.

`list_tags`

Lists all tags in the workspace.

Parameter	Type	Description
`type`	String	`sources`, `channels`, `updates` (optional)

Write-Tools

`create_source`

Creates a new source.

Parameter	Type	Description
`url`	String	Source website URL
`name`	String	Internal name
`tags`	Array	Tag IDs (optional)

`update_source`

Changes the name, URL, or tags of an existing source.

Parameter	Type	Description
`source_id`	String	Source ID
`name`	String	New name (optional)
`url`	String	New URL (optional)

`delete_source`

Deletes a source, including all channels and updates.

Parameter	Type	Description
`source_id`	String	Source ID

`create_channel`

Creates a channel manually.

Parameter	Type	Description
`source_id`	String	Parent source ID
`url`	String	Channel URL
`name`	String	Channel name (optional)

`update_channel`

Changes the name or description of a channel.

Parameter	Type	Description
`channel_id`	String	Channel ID
`name`	String	New name (optional)

`delete_channel`

Deletes a channel.

Parameter	Type	Description
`channel_id`	String	Channel ID

`toggle_channel`

Enables or disables a channel.

Parameter	Type	Description
`channel_id`	String	Channel ID
`active`	Boolean	`true` = active, `false` = inactive

`create_tag`

Creates a new tag.

Parameter	Type	Description
`name`	String	Tag name
`type`	String	`sources`, `channels`, or `updates`
`description`	String	AI tagging description (optional)

`update_tag`

Changes the name or description of a tag.

Parameter	Type	Description
`tag_id`	String	Tag ID
`name`	String	New name (optional)
`description`	String	New AI description (optional)