Skip to main content

MCP Tools

31 tools. 7 categories. Full MCP integration for any compatible client.

Every tool ships with pip install cohort. Two modes: Full (HTTP to running Cohort server) and Lite (file-backed, standalone).

31
MCP Tools
7
Categories
2
Operating Modes
Full + Lite
$0
All Tiers
Open source, forever
Tier legend: Free Included in open source Pro Requires Pro subscription Enterprise Enterprise only

Channel Management

6 tools
read_channelFree
Read recent messages from a channel with compact, token-optimized output. Supports limit and offset for pagination.
read-only
post_messageFree
Post a message to a channel as any sender. Supports @mentions for agent routing.
write
list_channelsFree
List all channels with compact output -- name, topic, message count, and last activity.
read-only
cohort_create_channelFree
Create a new chat channel with optional member list and topic. Auto-generates unique ID.
write
channel_summaryFree
Get a compact summary of recent channel activity -- who spoke, key topics, decision points.
read-only
condense_channelFree
Summarize old messages and archive originals. Keeps channels fast without losing history.
write

Task Management

7 tools
get_checklistFree
Read the to-do checklist with optional filtering by priority, category, or assignee.
read-only
update_checklistFree
Add, complete, or remove tasks on the to-do checklist. Supports priority and category tagging.
write
cohort_get_work_queueFree
Read the sequential work queue -- priority-ordered tasks with single-active constraint.
read-only
cohort_get_tasksFree
Read agent tasks with lifecycle tracking. Filter by status: pending, active, complete.
read-only
cohort_enqueue_itemFree
Add an item to the sequential work queue with priority, dependencies, and agent assignment.
write
cohort_claim_nextFree
Claim the next available work item. Respects priority ordering and dependency chains.
action
cohort_assign_taskFree
Assign a task to a specific agent via the work queue. Sets deliverables and acceptance criteria.
write

Agent Management

8 tools
cohort_list_agentsFree
List all agents with ID, role, status, and top skills. Optional flag to include hidden/inactive agents.
read-only
cohort_get_agentFree
Get full agent configuration by ID or alias. Returns personality, skills, domains, partners, and model params.
read-only
cohort_get_agent_memoryFree
Read an agent's persistent memory -- working memory, learned facts, or both. Filter by section.
read-only
cohort_create_agentFree
Create a new agent with full directory structure, config, prompt, and memory. Specify role, personality, skills, and group.
write
cohort_clean_memoryFree
Trim an agent's working memory, archiving old entries. Supports dry-run mode to preview changes.
write
cohort_add_factFree
Add a learned fact to an agent's persistent memory with topic, source, and confidence level (high/medium/low).
write
cohort_route_taskFree
Route a task to the best-qualified agent. Scores all active agents against the task using triggers, capabilities, and skill levels.
action
cohort_find_agentsFree
Find all agents qualified for a topic, ranked by capability match. Use for roundtable composition.
read-only

Collaboration & Discussion

4 tools
cohort_discussionFree
Run a multi-agent discussion. Each agent responds in turn with separate LLM calls. Best for complex workflow hand-offs.
action
cohort_compiled_discussionFree
All agent personas in a single LLM call -- ~90% token reduction vs separate calls. Best for 3-8 agent planning and review sessions.
action
cohort_adopt_personaFree
Load an agent's persona into the current conversation. Choose lightweight persona or full agent prompt.
read-only
cohort_partnership_graphFree
View the partnership graph -- who consults whom and why. Shows consultation protocols between agents.
read-only

Search & Retrieval

3 tools
cohort_search_messagesFree
Full-text search across all channels by keyword. Optional channel filter. Returns matching messages with context.
read-only
cohort_get_mentionsFree
Get messages where a specific agent was @mentioned. Configurable limit (1-100).
read-only
cohort_get_outputsFree
Get completed task outputs awaiting human review. The handoff point between agent work and your approval.
read-only

Briefing & Analysis

1 tool
cohort_generate_briefingFree
Generate an executive briefing for your Cohort deployment. Summarizes channel activity, task progress, agent performance, and blockers over a configurable time window.
action

Web Access

2 tools
internal_web_searchFree
Search the web locally using DuckDuckGo. No API key, no cost, no rate limits. Runs entirely on your machine. Optional time range filter.
read-only
internal_web_fetchFree
Fetch and render a web page locally using Playwright. Extracts readable text, metadata, and screenshots. No external API required.
read-only

Quick Setup

# Install
$ pip install cohort
# Add to your MCP client settings
{
"mcpServers": {
"cohort": {
"command": "python",
"args": ["-m", "cohort.mcp.server"]
}
}
}
# Or use the setup wizard
$ python -m cohort setup

Auto-detects between Full mode (HTTP to running Cohort server) and Lite mode (file-backed storage). No configuration needed.

31 Tools. Zero API Cost.

Every MCP tool ships with pip install cohort. Open source, forever.

Get Started Tools Overview