@jackgillen15-dev/scope-mcp
v0.1.1
Published
Scope MCP server - dispatch litigation work to legal-services vendors from any MCP-compatible AI workflow.
Maintainers
Readme
Scope MCP Server
The Model Context Protocol server for Scope - dispatch litigation work to legal-services vendors from Claude, Harvey, Eve, or any MCP-compatible AI workflow. The first vertical-services MCP for legal.
What is Scope?
Scope is the dispatch and verified-reputation layer between law firms and the litigation vendors who do the work - court reporters, records retrieval firms, expert witnesses, process servers, mediators, eDiscovery providers. Half of these vendors expose APIs. The other half take phone calls and PDF emails. Scope unifies both, and exposes the result through this MCP server so any AI legal workflow can dispatch work natively.
Learn more: scope-bid.vercel.app
What this server does
Once connected to Claude Desktop, Claude Code, Cursor, Claude Cowork, or any other MCP-compatible client, your AI assistant gains five tools for dispatching and tracking real-world legal-services work:
| Tool | Purpose |
|---|---|
| scope_list_categories | List Scope's service categories (court reporting, records retrieval, social media evidence, expert witness, etc.) and which are API-native vs ops-backed |
| scope_list_vendors | List verified vendors with verified-reputation snapshots (on-time %, budget variance, rework rate, completed matters, satisfaction) |
| scope_dispatch_matter | Post a sealed-bid matter to the network. Vendors are notified; bids close after the configured window |
| scope_get_matter | Look up a matter by display id (e.g. SC-2041) or UUID. Returns scope details, bids, award status |
| scope_list_matters | List matters in flight for the calling buyer organization |
Example: dispatching a deposition from Claude
You: A deposition notice just came in for Smith v. Acme. Witness John Doe,
scheduled for May 15 in San Diego, video and real-time required.
Send this out to court reporters with verified track records in CA.
Claude (calls scope_dispatch_matter):
title: "Deposition - John Doe - Smith v. Acme"
service_category: "court-reporting"
jurisdictions: ["CA"]
description: "Witness deposition. Date: May 15. Location: San Diego.
Video and real-time required. ~4 hours expected."
bid_window_minutes: 60
Scope returns:
matter_id: "SC-2089"
status: "open"
vendors_notified: 7
bid_window_closes: "2026-05-04T17:30:00Z"
You: When the bids come in, summarize them with their reputation scores.
Claude (60 min later, calls scope_get_matter):
...4 sealed bids, names hidden until award, reputation snapshots side-by-side.Install
Prerequisites
- Node.js 18 or newer
- A Scope account (sign up at scope-bid.vercel.app/signup)
- An MCP-compatible client - Claude Desktop, Claude Code, Cursor, or any client speaking MCP 2025-11-25
Build from source
git clone https://github.com/scope-bid/scope-mcp.git
cd scope-mcp
npm install
npm run buildThis produces dist/server.js.
Configure in Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"scope": {
"command": "node",
"args": ["/absolute/path/to/scope-mcp/dist/server.js"],
"env": {
"SCOPE_API_BASE": "https://scope-bid.vercel.app",
"SCOPE_API_TOKEN": "your-token-from-scope-bid",
"SCOPE_ORG_SLUG": "your-org-slug"
}
}
}
}Restart Claude Desktop. The Scope tools should appear when you click the tools icon.
Configure in Claude Code
Add an .mcp.json to your project root:
{
"mcpServers": {
"scope": {
"command": "node",
"args": ["/absolute/path/to/scope-mcp/dist/server.js"],
"env": {
"SCOPE_API_BASE": "https://scope-bid.vercel.app",
"SCOPE_API_TOKEN": "your-token-from-scope-bid"
}
}
}
}Configure in Cursor
Cursor reads MCP servers from the same .mcp.json format. Add the file to your workspace root and restart Cursor.
Environment variables
| Variable | Required | Default | Notes |
|---|---|---|---|
| SCOPE_API_BASE | No | https://scope-bid.vercel.app | Override for self-hosted Scope deployments |
| SCOPE_API_TOKEN | For write tools | - | Bearer token. Required for scope_dispatch_matter. Read-only tools work without it on demo matters. Generate at scope-bid.vercel.app/settings |
| SCOPE_ORG_SLUG | No | - | Pin reads/writes to a specific buyer organization. Useful for multi-tenant deployments where one Scope account represents multiple firms |
Roadmap
V1 ships these five tools. Coming next:
scope_get_vendor_reputation- deep dive on a single vendor's verified track recordscope_award_matter- award a matter to a chosen bidderscope_attach_deliverable- upload a transcript, record set, or report against a matterscope_record_completion- close out a matter (vendor-side) and trigger reputation recompute
Plus per-category specialized tools as Scope's V1 categories expand:
scope_book_deposition(court reporting)scope_request_records(records retrieval)scope_preserve_social_media(social media evidence)scope_retain_expert(expert witnesses)
Why MCP for legal services?
Anthropic shipped the Model Context Protocol in late 2024, and the Claude Legal Plugin in February 2026. The plugin handles content generation - contract review, NDA triage, drafting briefs. It cannot dispatch real work to real vendors. That's the gap this server fills.
The first vertical-services MCP for legal services is genuinely first-mover. As of May 2026, no MCP server has been published for any vertical-services industry (legal, AEC, healthcare, claims). Scope-as-MCP-for-legal is the opening shot.
Development
npm run dev # tsx hot-reload
npm run build # compile to dist/
npm run start # run compiled serverThe server uses stdio transport (the default for local MCP clients). For remote/HTTP transport, see the MCP HTTP transport spec - support coming in a future release.
Contributing
This is a young project. Bug reports, feature requests, and PRs welcome. For larger changes, please open an issue first to discuss what you'd like to change.
License
MIT - see LICENSE.
Contact
Built by Jack Gillen for Scope.
For Scope-account questions: [email protected] For MCP server bugs: open a GitHub issue.
The work speaks.
