ProtoMCP
Prototype
For demonstration purposes only. This prototype uses sample data and is intended for internal testing and evaluation. Not connected to production systems.
This server powers two different AI integration modes for BARBRI content:
For Claude Desktop, Code, and Cursor - Provides tools that return metadata and links. Users click through to view full content. Privacy-focused approach.
Native study assistant - Vue 3 application with direct API access. Returns full content, manages conversations, tracks progress. Built specifically for law students.
Same Backend, Different Access: The MCP server and Debora REST API share the same database and content. The difference is in how content is delivered—MCP returns links, Debora returns full content via authenticated API calls.
The Model Context Protocol (MCP) is an open standard developed by Anthropic that allows AI assistants like Claude to securely connect with external systems. For BARBRI, this means Claude can:
Privacy by Design: MCP tools return metadata and links—not full content. Users click through to access materials. This ensures content stays on BARBRI's platform and user activity is tracked appropriately.
Debora is a purpose-built web application (Vue 3 + Vite) that provides law students with an AI-powered study companion. Unlike MCP integration, Debora has direct access to full content through authenticated REST APIs.
Integration Architecture: Debora uses special headers (X-Debora-Client: true, X-Debora-Mode: full-content) to request complete content from API endpoints. This enables a seamless study experience while maintaining access control.
Both integration modes share the same backend but deliver content differently based on the client.
Technical Detail: The same API endpoints serve both modes. When Debora makes a request with X-Debora-Mode: full-content header, the server includes complete content in the response. MCP requests receive metadata only.
These endpoints are exclusively for the Debora web application and require Debora-specific authentication headers:
| Endpoint | Method | Purpose |
|---|---|---|
/api/debora/conversations |
GET, POST, PUT | List, create, and update AI conversation sessions |
/api/debora/messages |
GET, POST | Retrieve and save conversation messages with full context |
/api/mcp/* + Debora headers |
GET | All MCP endpoints return full content when called with Debora headers |
X-Debora-Client: true
X-Debora-Mode: full-content
X-Debora-User-ID: <user_id> // For authenticated requests
X-Debora-Session: <session_id> // For conversation tracking
X-Debora-Token: <jwt_token> // Alternative authentication
Security: Debora endpoints enforce authentication. Write operations (creating conversations, saving messages) require a valid X-Debora-User-ID or X-Debora-Token. Content endpoints check permissions before returning full text.
Here's how a typical interaction might look:
When someone needs help with a topic, relevant study materials are one question away—whether through MCP links or Debora's inline content.
Find resources through conversation instead of navigating menus and catalogs. Claude's AI understanding matches user intent with the right content.
Go from question to hands-on study materials in seconds. MCP for quick lookups, Debora for deep study sessions.
Debora remembers your study sessions. Resume conversations, build collections, and track progress over time.
Use Claude in your preferred environment—integrated with your code editor or as a dedicated study companion.
Full BARBRI content stays on BARBRI servers. MCP shares links only; Debora delivers content to authenticated users only.
Once connected, Claude can use these tools to search and retrieve BARBRI content. Tools are categorized by audience so Claude recommends the right content for each user.
Works in Both Modes: These tools function identically in MCP and Debora, but return different content based on the client. MCP requests receive metadata + links. Debora requests (with X-Debora-Mode: full-content header) receive complete content including full text, media, and data.
Find case briefs with IRAC analysis for landmark cases like Palsgraf, Hadley v. Baxendale, and more.
Get details about a specific case brief including available formats and media.
Faculty video discussions of landmark cases with analysis and exam tips.
Study flashcard decks for memorizing legal rules, elements, and definitions.
Get details about a specific flashcard deck including topics covered.
Search individual flashcards by subject/topic to build custom study decks.
Build a personalized study deck from selected flashcard IDs.
Practice quizzes to test knowledge across all law school subjects.
Get details about a specific quiz including time limit and topics.
Law school essay practice with timed prompts and model answers.
Comprehensive subject outlines created by expert faculty.
Legal glossary with definitions, examples, and related cases.
Animated case explainers and instructor lectures for law school subjects.
Podcasts and audio lectures for on-the-go learning.
Hornbooks, nutshells, Examples & Explanations, and study guides.
Get book details including full chapter listing and table of contents.
Law school practice scenarios: Socratic cold calls, office hours, moot court, study groups, exam debriefs, and clinic interviews.
Personalized bar prep schedule with daily assignments and progress.
Track completion status by subject and week.
MBE-focused flashcard decks for bar exam memorization.
Launch interactive MBE practice quizzes on the BARBRI platform.
Search MBE questions by subject/topic to build custom quizzes.
Build a personalized practice quiz from selected question IDs.
MEE-style essay prompts for UBE preparation with model answers.
Comprehensive video lectures by bar exam faculty.
Full-length audio reviews for each MBE subject.
Bar review materials, MBE strategies, and essay writing guides.
Interactive practice exercises for client intake, negotiation, depositions, and more — plus law school scenarios like cold calls and moot court.
Get details about a simulation including learning objectives and phases.
Generate URL to start a simulation in the browser with voice/text AI.
CLE courses by subject, format, or jurisdiction for practicing attorneys.
Track CLE credits earned and compliance status by jurisdiction.
NASBA-approved CPE courses for accountants and CPAs.
Practical training for drafting, negotiation, research, courtroom skills.
Short video lessons (4-6 min) for quick concept review.
Practice manuals for discovery, depositions, and professional reference.
OAuth sign-in to access personalized progress and study plans.
View learning progress across all BARBRI products.
Privacy by Design: MCP mode: Claude receives metadata and links—not full content. Users click through to view materials. Debora mode: Full content is returned only to authenticated Debora clients with valid user sessions. All content access is logged and tracked.
These instructions are for setting up the MCP integration with Claude Desktop, Claude Code (CLI), or Cursor IDE. For Debora, simply visit the web application URL (setup not required).
Choose your MCP platform:
One-command installation:
curl -sL https://mcp.aarondewald.com/downloads/install.sh | bash
Then restart Claude Desktop (Cmd+Q and reopen).
Prerequisites: Node.js 18+ must be installed. Download the server files first if using manual setup: barbri-mcp.zip
MCP integrates Claude with your local desktop apps (Claude Desktop, Code, Cursor) and returns links to content. Debora is a dedicated web application that includes full content inline and manages conversations/collections. Both use the same backend server and content database.
MCP Mode: Claude calls tools via the MCP protocol and receives metadata (titles, descriptions, links). Users click through to view materials.
Debora Mode: The web app's backend calls the same APIs with special headers to receive full content, which is then displayed inline within the study interface.
MCP: The server runs locally on your machine. Authentication uses OAuth with your BARBRI account. Claude sees only metadata.
Debora: The web app connects to the server via HTTPS. Conversations are stored server-side with user authentication. Full content is only returned to authenticated Debora clients.
Browsing the content catalog works without an account in both modes. Personalized features (study plans, progress tracking, conversation history, collections) require signing in with your BARBRI account.
Yes! They're complementary. Use MCP with Claude Desktop/Code for quick content lookups during coding or research. Use Debora for focused study sessions with conversation history and content collections. Both access the same BARBRI content library.
Tools are individual actions (search, get, launch). Prompts are pre-built workflows that combine multiple tools into structured sessions. Prompts save time by automating common learning patterns. Available in MCP mode.
Claude can help you practice with BARBRI's essay prompts and compare your answers to model answers, but learning to write essays yourself is essential for passing the bar. Use Claude as a study partner, not a shortcut.
This is a prototype for internal testing. Contact your BARBRI representative with feedback or issues.
After connecting, try asking Claude based on your role: