Tools
The Obris MCP server exposes read-only tools that give your experts access to curated knowledge.
list_topics
List all topics in the authenticated user's account. Call this first to discover available topics and their IDs.
Parameters
- Name
cursor- Type
- string
- Description
Pagination cursor from a previous call. Omit for the first page.
- Name
limit- Type
- number
- Description
Max topics to return per page (1-100, default 50).
Response format
- Name
name- Type
- string
- Description
The topic name.
- Name
description- Type
- string
- Description
Optional topic description.
- Name
id- Type
- string
- Description
Unique topic ID. Pass this to
get_topic_knowledge.
- Name
item_count- Type
- number
- Description
Number of saved knowledge items in the topic.
Example output
**Great Cold Emails**
Curated examples of effective outreach emails
- ID: abc123
- Knowledge Count: 8
**Competitor Pricing**
- ID: def456
- Knowledge Count: 5
get_topic_knowledge
Get the saved knowledge for a specific topic. Returns the title, content, and metadata for each item.
Parameters
- Name
topic_id- Type
- string
- Description
The topic ID returned by
list_topics. Required.
- Name
cursor- Type
- string
- Description
Pagination cursor from a previous call. Omit for the first page.
- Name
client_hint- Type
- string
- Description
Client type hint to optimize response size. Values:
claude-code,claude,chatgpt,gemini.
Response format
Each knowledge item includes:
- Name
title- Type
- string
- Description
The title of the saved item.
- Name
id- Type
- string
- Description
Unique item ID.
- Name
content- Type
- string
- Description
The full saved content (for small items).
- Name
summary- Type
- string
- Description
A summary of the content (for large items and file uploads).
- Name
file_url- Type
- string
- Description
Download URL for the full content (for large items and file uploads).
- Name
url- Type
- string
- Description
Source URL where the content was captured from.
Example output
### How We Booked 50 Meetings in 30 Days (id: ref001)
The key to effective cold outreach is personalization at scale.
Start with a compliment or observation specific to the recipient...
(source: https://example.com/cold-email-guide)
### The Perfect Follow-Up Sequence (id: ref002)
Most replies come from the 2nd or 3rd follow-up, not the initial email.
Here's the exact sequence we use...
(source: https://example.com/follow-up-strategy)
Usage examples
Here are some prompts your team can try once an expert is connected to their AI tool:
Browse your topics
List my Obris topics
The expert will call list_topics and show you a summary of all your topics along with their knowledge counts.
Analyze saved content
What are the common principles from the emails in Great Cold Emails?
The expert will call list_topics to find the topic ID, then get_topic_knowledge to retrieve the saved emails, and synthesize the key patterns across them.
AI platforms decide when to invoke MCP tools. If your expert does not use your Obris data, try mentioning "Obris" explicitly, for example "Using Obris, find my knowledge about..."