MCP-Tools - Overview
Access Rights
MCP tools are assigned to three scope levels:
| Scope | Meaning |
|---|---|
read | Read-only access; cannot create, edit, or delete |
write | Read and write sources, channels, and inbox; no access to team settings |
admin | Full MCP access including team settings |
For OAuth connections, the scope selected during authorization limits which tools can be accessed. For API tokens, the token role determines the maximum access level.
Read Tools
All read tools require at least scope read.
search_updates
Searches updates by search terms, sources, tags, and time period.
Required scope: read
| 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.
Required scope: read
| Parameter | Type | Description |
|---|---|---|
update_id | String | ID of the update |
list_sources
Lists all sources in the workspace.
Required scope: read
| Parameter | Type | Description |
|---|---|---|
active_only | Boolean | Return only active sources (default: true) |
list_reports
Lists available AI reports.
Required scope: read
| 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.
Required scope: read
| Parameter | Type | Description |
|---|---|---|
report_id | String | Report ID |
get_team_context
Returns the AI context of the workspace (website URL and context documents).
Required scope: read
No parameters.
list_tags
Lists all tags in the workspace.
Required scope: read
| Parameter | Type | Description |
|---|---|---|
type | String | sources, channels, updates (optional) |
Write Tools
All Write Tools require at least scope write.
create_source
Creates a new source.
Required scope: write
| 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.
Required scope: write
| 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.
Required scope: write
| Parameter | Type | Description |
|---|---|---|
source_id | String | Source ID |
create_channel
Creates a channel manually.
Required scope: write
| 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.
Required scope: write
| Parameter | Type | Description |
|---|---|---|
channel_id | String | Channel ID |
name | String | New name (optional) |
delete_channel
Deletes a channel.
Required scope: write
| Parameter | Type | Description |
|---|---|---|
channel_id | String | Channel ID |
toggle_channel
Enables or disables a channel.
Required scope: write
| Parameter | Type | Description |
|---|---|---|
channel_id | String | Channel ID |
active | Boolean | true = active, false = inactive |
create_tag
Creates a new tag.
Required scope: write
| 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.
Required scope: write
| Parameter | Type | Description |
|---|---|---|
tag_id | String | Tag ID |
name | String | New name (optional) |
description | String | New AI description (optional) |