1. Conduid
  2. AI
  3. The Academy
MCP server · AI

The Academy

by · github.com/im-knots/the-academy

A Socratic dialogue engine for AI agents.

Unclaimed MIT last commit 10 months ago claudeagent-to-agentchatgptllmagent-based-simulationeru-labsaiconversational-agents
InstallView source
59Fair

Scored 5 months ago · breakdown

About The Academy

The Academy is an MCP server published by im-knots in the AI category: a Socratic dialogue engine for AI agents.

The repository has 16 stars and 2 forks, with the last commit 10 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/im-knots/the-academy

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (15)

create_sessionCreate new conversation session

Parameters not published.

create_session_from_templateCreate from template

Parameters not published.

delete_sessionDelete a session

Parameters not published.

duplicate_sessionClone existing session

Parameters not published.

get_current_session_idGet active session ID

Parameters not published.

get_sessionGet session by ID (includes analysis snapshots)

Parameters not published.

get_session_analysis_configGet analysis settings

Parameters not published.

get_session_chat_configGet chat settings

Parameters not published.

get_sessionsList all sessions

Parameters not published.

import_sessionImport session data

Parameters not published.

Show all 15 tools
list_templatesList session templates

Parameters not published.

switch_current_sessionChange active session

Parameters not published.

update_sessionUpdate session metadata

Parameters not published.

update_session_analysis_configUpdate analysis settings

Parameters not published.

update_session_chat_configUpdate chat settings

Parameters not published.

Ask AI

✦

Ask AI about The Academy

Powered by Claude · Grounded in docs

I know everything about The Academy. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 3 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

1 check has not been run yet.

README

The Academy

A Socratic dialogue engine for AI agents with Model Context Protocol (MCP) integration. Run multi-agent conversations, execute bulk experiments, and analyze dialogue patterns all controllable through 70+ MCP tools.

The Academy

Key Features

Feature Description
Multi-Agent Dialogues Autonomous conversations between Claude, GPT, Gemini, Grok, and other AI models
Bulk Experiments Run hundreds of sessions concurrently with configurable parallelism
Live Analysis Real-time AI-powered conversation analysis with customizable output schema
MCP Integration 70+ tools exposing all functionality programmatically
8 AI Providers Claude, GPT, Gemini, Grok, Deepseek, Mistral, Cohere, and Ollama
Moderator Controls Pause, resume, and inject guidance during conversations

Supported Providers

Bulk Experiments

Design and execute large-scale conversation studies with the visual experiment designer.

Bulk Experiments Bulk Experiments

MCP Integration

The Academy exposes an MCP server at /api/mcp with 70+ tools organized into categories:

MCP Resources

Resource Description
academy://sessions All conversation sessions with metadata
academy://session/{id} Individual session with participants and messages
academy://session/{id}/messages Complete message history
academy://session/{id}/analysis Analysis snapshots
academy://experiments All experiment configurations
academy://experiment/{id}/results Experiment results and analytics

MCP Tools

Session Management

Tool Description
create_session Create new conversation session
get_session Get session by ID (includes analysis snapshots)
get_sessions List all sessions
delete_session Delete a session
update_session Update session metadata
switch_current_session Change active session
duplicate_session Clone existing session
import_session Import session data
list_templates List session templates
create_session_from_template Create from template
get_current_session_id Get active session ID
get_session_analysis_config Get analysis settings
update_session_analysis_config Update analysis settings
get_session_chat_config Get chat settings
update_session_chat_config Update chat settings

Participant Management

Tool Description
add_participant Add AI agent to conversation
remove_participant Remove participant
update_participant Modify participant settings
update_participant_status Change participant state
get_participant_config Get participant configuration
list_available_models List available AI models

Conversation Control

Tool Description
start_conversation Begin autonomous dialogue
pause_conversation Pause active conversation
resume_conversation Resume paused conversation
stop_conversation End conversation
get_conversation_status Check conversation state
get_conversation_stats Get conversation metrics

Message Management

Tool Description
send_message Send message to session
update_message Update message content
delete_message Delete a message
clear_messages Clear all messages
inject_moderator_prompt Insert moderator message

Analysis Tools

Tool Description
analyze_conversation Extract insights and patterns
trigger_live_analysis Run real-time analysis
save_analysis_snapshot Store analysis data
get_analysis_history Get past analyses
clear_analysis_history Remove analysis data
set_analysis_provider Set analysis AI provider
get_analysis_providers List analysis providers
auto_analyze_conversation Toggle auto-analysis

Export Tools

Tool Description
export_session Export conversation data (JSON/CSV)
export_analysis_timeline Export analysis history
get_export_preview Preview export content

AI Provider Tools

Tool Description
claude_chat Claude API with retry logic
openai_chat OpenAI API with retry logic
grok_chat Grok API with retry logic
gemini_chat Gemini API with retry logic
deepseek_chat Deepseek API with retry logic
mistral_chat Mistral API with retry logic
cohere_chat Cohere API with retry logic
ollama_chat Ollama API with retry logic

Experiment Management

Tool Description
create_experiment Create experiment configuration
get_experiments List all experiments
get_experiment Get experiment details
update_experiment Update experiment config
delete_experiment Delete experiment
create_experiment_run Create new run
update_experiment_run Update run status
get_experiment_run Get run details

Experiment Execution

Tool Description
execute_experiment Execute bulk experiment
get_experiment_status Get execution progress
pause_experiment Pause running experiment
resume_experiment Resume paused experiment
stop_experiment Stop experiment
get_experiment_results Get aggregated results

Debug Tools

Tool Description
debug_store Debug database state
get_api_errors Get API errors with retry details
clear_api_errors Clear error logs
log_api_error Log an API error

Example Usage

// Start a conversation
await mcp.callTool('start_conversation', { sessionId, initialPrompt })

// Run bulk experiment
const exp = await mcp.callTool('create_experiment', {
  config: { name: 'Study', totalSessions: 50, concurrentSessions: 5 }
})
await mcp.callTool('execute_experiment', { experimentId: exp.experimentId })

// Export with analysis
await mcp.callTool('export_session', { sessionId, includeAnalysis: true })

Use Cases

  • Multi-agent research — Study AI model interactions in extended conversations
  • Parameter studies — Test temperature, prompts, and settings systematically
  • Model comparison — Compare AI models on identical tasks
  • Bulk experiments — Run large-scale studies programmatically
  • Synthetic data generation — Create conversational datasets

Tech Stack

Next.js 15 • PostgreSQL • TypeScript • Tailwind CSS • MCP (JSON-RPC 2.0) • Docker

Getting Started

Prerequisites

  • Node.js 18+
  • Docker (for PostgreSQL)
  • API keys for providers you want to use

Quick Start

# Clone and start database
git clone https://github.com/yourname/the-academy.git
cd the-academy
docker-compose up -d

# Install and run
cd academy
pnpm install
pnpm dev

Environment Variables

Create academy/.env.local:

# AI Providers (add keys for providers you want to use)
ANTHROPIC_API_KEY=your_key
OPENAI_API_KEY=your_key
XAI_API_KEY=your_key
GOOGLE_AI_API_KEY=your_key
DEEPSEEK_API_KEY=your_key
MISTRAL_API_KEY=your_key
COHERE_API_KEY=your_key

# Database
DATABASE_URL=postgresql://academy_user:academy_password@localhost:5432/academy_db

Visit http://localhost:3000

Contributing

Contributions welcome! Areas of interest:

  • Additional AI provider integrations
  • Analysis algorithms and templates
  • UI/UX improvements
  • Export format extensions

License

MIT License

README fetched from the repository 3 hours ago. The original is authoritative.

Questions

About The Academy

How do I install The Academy?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is The Academy safe to use with an AI agent?

Its trust score is 59 out of 100 (fair). It passes 3 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is The Academy still maintained?

The last commit was 10 months ago and 13 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.