Tools
The Obris MCP server exposes two read-only tools that give AI assistants access to your saved web content.
list_projects
List all projects in the authenticated user's account. Call this first to discover available projects and their IDs.
Parameters
No parameters required.
Response format
- Name
name- Type
- string
- Description
The project name.
- Name
description- Type
- string
- Description
Optional project description.
- Name
id- Type
- string
- Description
Unique project ID. Pass this to
get_project_references.
- Name
reference_count- Type
- number
- Description
Number of saved references in the project.
- Name
created_at- Type
- string
- Description
Date the project was created (YYYY-MM-DD).
Example output
Found 2 project(s):
**Great Cold Emails**
Curated examples of effective outreach emails
- ID: abc123
- References: 8
- Created: 2025-11-03
**Competitor Pricing**
- ID: def456
- References: 5
- Created: 2025-12-15
get_project_references
Get the saved references for a specific project. Returns the title, URL, type, and content of each reference.
Parameters
- Name
project_id- Type
- string
- Description
The project ID returned by
list_projects. Required.
Response format
Each reference includes:
- Name
title- Type
- string
- Description
The title of the saved reference.
- Name
id- Type
- string
- Description
Unique reference ID.
- Name
url- Type
- string
- Description
Source URL where the content was captured from.
- Name
source_type- Type
- string
- Description
Type of content (e.g.
webpage,email,pdf).
- Name
content- Type
- string
- Description
The full saved content of the reference.
Example output
Found 2 reference(s) in project:
**How We Booked 50 Meetings in 30 Days**
- ID: ref001
- URL: https://example.com/cold-email-guide
- Type: webpage
The key to effective cold outreach is personalization at scale.
Start with a compliment or observation specific to the recipient...
---
**The Perfect Follow-Up Sequence**
- ID: ref002
- URL: https://example.com/follow-up-strategy
- Type: webpage
Most replies come from the 2nd or 3rd follow-up, not the initial email.
Here's the exact sequence we use...
Usage examples
Here are some prompts you can try once the Obris MCP server is connected to your AI platform:
Browse your projects
List my Obris projects
The AI assistant will call list_projects and show you a summary of all your projects along with their reference counts.
Analyze saved content
What are the common principles from the emails in Great Cold Emails?
The AI assistant will call list_projects to find the project ID, then get_project_references to retrieve the saved emails, and synthesize the key patterns across them.
Compare references
Compare the pricing tiers across my saved competitors
The AI assistant will locate your competitor pricing project, pull in all the saved references, and produce a side-by-side comparison of the pricing structures.
AI platforms decide when to invoke MCP tools. If your assistant doesn't reference your Obris data, try mentioning "Obris" explicitly — for example, "Using Obris, find my references about..."