BARBRI ProtoMCP Prototype

For demonstration purposes only. This prototype uses sample data and is intended for internal testing and evaluation. Not connected to production systems.

1,463
Case Briefs
900
Videos
1,126
Practice Questions
2,147
Flashcards
72
Essays + Answers
45
Outlines
729
Key Terms
67
Book Chapters
49
Simulations
22
Audio Content
81
CLE/CPE Courses

explore Two Ways to Connect

This server powers two different AI integration modes for BARBRI content:

hub

MCP Integration

For Claude Desktop, Code, and Cursor - Provides tools that return metadata and links. Users click through to view full content. Privacy-focused approach.

chat

Debora Web App

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.

hub MCP Integration

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.

school Debora: AI Study Assistant

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.

Key Features

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.

settings_suggest How It Works

Both integration modes share the same backend but deliver content differently based on the client.

MCP Flow (Claude Desktop/Code/Cursor)

smart_toy
User asks Claude
about a topic
arrow_forward
search
Claude calls
MCP tools
arrow_forward
link
Metadata + links
returned
arrow_forward
open_in_new
User clicks to
view content

Debora Flow (Web Application)

person
Student asks
question
arrow_forward
cloud
Claude API
with streaming
arrow_forward
hub
MCP tools fetch
full content
arrow_forward
view_agenda
Content cards
render inline

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.

api Debora REST API

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

Required 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.

Example Conversation

Here's how a typical interaction might look:

person
Law Student

I'm studying for my Torts exam and keep getting confused about proximate cause. Can you help me understand it better?

smart_toy
Claude

Proximate cause asks whether the defendant's negligent act was closely enough connected to the plaintiff's injury. The key case to understand is Palsgraf v. Long Island Railroad.

I found a case brief on BARBRI that breaks down this landmark case:

Palsgraf v. Long Island Railroad Co.
Torts · Proximate Cause · 1928
Landmark case establishing that duty in negligence runs only to foreseeable plaintiffs. Includes full IRAC analysis, summary, and bullet-point formats.
open_in_new View Case Brief

I also found flashcards and a quiz on negligence if you want to test your understanding.

rocket_launch Why It Matters

schedule

Just-in-Time Learning

When someone needs help with a topic, relevant study materials are one question away—whether through MCP links or Debora's inline content.

psychology

Natural Discovery

Find resources through conversation instead of navigating menus and catalogs. Claude's AI understanding matches user intent with the right content.

bolt

Faster to Practice

Go from question to hands-on study materials in seconds. MCP for quick lookups, Debora for deep study sessions.

history

Persistent Context

Debora remembers your study sessions. Resume conversations, build collections, and track progress over time.

extension

Flexible Integration

Use Claude in your preferred environment—integrated with your code editor or as a dedicated study companion.

verified_user

Content Control

Full BARBRI content stays on BARBRI servers. MCP shares links only; Debora delivers content to authenticated users only.

build Available Tools

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.

search_case_briefs

Find case briefs with IRAC analysis for landmark cases like Palsgraf, Hadley v. Baxendale, and more.

Sees: title, citation, subject, author
Not: full brief text

get_case_brief

Get details about a specific case brief including available formats and media.

Sees: metadata, variants, author, URL
Not: full brief text

search_case_brief_videos

Faculty video discussions of landmark cases with analysis and exam tips.

Sees: title, presenter, duration
Not: video content

search_flashcard_decks

Study flashcard decks for memorizing legal rules, elements, and definitions.

Sees: deck name, card count, subject
Not: card content

get_flashcard_deck

Get details about a specific flashcard deck including topics covered.

Sees: deck info, card count, URL
Not: card content

search_flashcards

Search individual flashcards by subject/topic to build custom study decks.

Sees: card ID, subject, front preview
Not: full card content

create_custom_deck

Build a personalized study deck from selected flashcard IDs.

Sees: card IDs, deck URL
Not: card content

search_quizzes

Practice quizzes to test knowledge across all law school subjects.

Sees: title, subject, question count
Not: questions or answers

get_quiz

Get details about a specific quiz including time limit and topics.

Sees: quiz info, question count, URL
Not: questions or answers

search_practice_essays

Law school essay practice with timed prompts and model answers.

Sees: title, subject, time limit
Not: prompts or model answers

search_outlines

Comprehensive subject outlines created by expert faculty.

Sees: title, subject, author
Not: outline content

search_key_terms

Legal glossary with definitions, examples, and related cases.

Sees: term name, subject
Not: definitions

search_lesson_videos

Animated case explainers and instructor lectures for law school subjects.

Sees: title, topic, presenter, duration
Not: video content

search_audio_content

Podcasts and audio lectures for on-the-go learning.

Sees: title, series, episode, duration
Not: audio content

search_books

Hornbooks, nutshells, Examples & Explanations, and study guides.

Sees: title, author, type, chapters
Not: book content

get_book_details

Get book details including full chapter listing and table of contents.

Sees: chapters, topics, page ranges
Not: book content

search_simulations

Law school practice scenarios: Socratic cold calls, office hours, moot court, study groups, exam debriefs, and clinic interviews.

Sees: title, skills, objectives
Not: simulation content

get_study_plan

Personalized bar prep schedule with daily assignments and progress.

Sees: tasks, schedule, completion %
Not: adaptive algorithm, scores

get_study_progress

Track completion status by subject and week.

Sees: completion by subject
Not: detailed analytics, scores

search_bar_flashcards

MBE-focused flashcard decks for bar exam memorization.

Sees: deck name, subject, card count
Not: card content

get_mbe_practice

Launch interactive MBE practice quizzes on the BARBRI platform.

Sees: subject, question count
Not: questions or answers

search_mbe_questions

Search MBE questions by subject/topic to build custom quizzes.

Sees: question ID, subject, preview
Not: full question content

create_custom_quiz

Build a personalized practice quiz from selected question IDs.

Sees: question IDs, quiz URL
Not: question content

search_bar_essays

MEE-style essay prompts for UBE preparation with model answers.

Sees: title, subject, jurisdiction
Not: prompts or model answers

search_lesson_videos

Comprehensive video lectures by bar exam faculty.

Sees: title, topic, presenter, duration
Not: video content

search_audio_content

Full-length audio reviews for each MBE subject.

Sees: title, subject, duration
Not: audio content

search_books

Bar review materials, MBE strategies, and essay writing guides.

Sees: title, author, type, chapters
Not: book content

search_simulations

Interactive practice exercises for client intake, negotiation, depositions, and more — plus law school scenarios like cold calls and moot court.

Sees: title, skills, practice area
Not: simulation content

get_simulation

Get details about a simulation including learning objectives and phases.

Sees: objectives, skills, duration
Not: simulation content

launch_simulation

Generate URL to start a simulation in the browser with voice/text AI.

Sees: launch URL
Not: simulation content

search_cle_courses

CLE courses by subject, format, or jurisdiction for practicing attorneys.

Sees: title, credits, subject
Not: course content

get_cle_progress

Track CLE credits earned and compliance status by jurisdiction.

Sees: credits earned, deadlines
Not: payment info

search_cpe_courses

NASBA-approved CPE courses for accountants and CPAs.

Sees: title, credits, field of study
Not: course content

search_skills_modules

Practical training for drafting, negotiation, research, courtroom skills.

Sees: title, skill type, format
Not: module content

search_microlearning

Short video lessons (4-6 min) for quick concept review.

Sees: title, topic, duration
Not: video content

search_books

Practice manuals for discovery, depositions, and professional reference.

Sees: title, author, type, chapters
Not: book content

connect_barbri_account

OAuth sign-in to access personalized progress and study plans.

Sees: name, email (with consent)
Not: password, payment info

get_learner_progress

View learning progress across all BARBRI products.

Sees: completion status
Not: scores, detailed analytics

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.

devices MCP Platform Setup

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:

Claude Desktop (macOS)

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

help Frequently Asked Questions

What's the difference between MCP and Debora?

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.

How does Claude access BARBRI content in each mode?

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.

Is my data secure?

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.

Do I need a BARBRI account?

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.

Can I use both MCP and Debora?

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.

What's the difference between Tools and Prompts?

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.

Can Claude write my bar exam essays for me?

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.

How do I report issues or give feedback?

This is a prototype for internal testing. Contact your BARBRI representative with feedback or issues.

play_circle Try It Out

After connecting, try asking Claude based on your role:

As a Law Student:

As a Bar Exam Taker:

As a Practicing Attorney: