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 determines 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 keywords, 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)
source_ownership	String	all (default), own (only own sources), or competitor (only external sources)
limit	Integer	Number of results (default: 20, max: 100)

The source_ownership filter uses the is_own field at the source. It is the counterpart to the ownership filter in the Inbox UI and allows the AI assistant to specifically view only its own presence or only competitors.

---

get_update_details

Returns the full content of a single update.

Required Scope: read

Parameter	Type	Description
update_id	String	Update ID

---

list_sources

Lists all sources in the workspace.

Required Scope: read

Parameter	Type	Description
is_own	Boolean	true = own sources only, false = competitors only, omit = all

Each returned source contains the is_own field so that AI assistants can distinguish between their own presence and that of competitors without having to make a second request.

---

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: team metadata (name, language, time zone), website URL, context documents, and ownership configuration.

Required scope: read

No required parameters.

The response contains the following in the context block:

• website_url – stored organization URL
• is_own_sources_configured – true, as soon as at least one source is marked as its own
• own_sources_count – number of its own sources

AI assistants should only offer Voice Share or Momentum comparisons if is_own_sources_configured is true — otherwise, there is no basis for comparison.

---

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

Manually creates a channel.

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)

---

Related Topics

MCP — Using Picasi in the AI Assistant Background: What MCP is, OAuth scope levels, and the security concept.

Connect Picasi to Claude Code Create an API token and set it up in Claude Code.

Connect Picasi to Claude.ai Set up an OAuth connection for Claude.ai.