Dispatch litigation, insurance claims, and AEC work to credentialed professionals and retrieve real-time pricing from their rate cards.
Also known as scope-bid/scope-mcp, scope-mcp-eae94b, @jackgillen15-dev/scope-mcp
- Stars
- 1
- Tools
- 5
- Downloads, 30 days
- 163
- Latest version
- 0.1.1
- Last commit
- Nov 15, 2026
- License
- Apache-2.0
What is Scope MCP?
Scope is an MCP server. Dispatch litigation, insurance claims, and AEC work to credentialed professionals and retrieve real-time pricing from their rate cards. It exposes 5 tools, such as scope_list_categories, scope_list_vendors, scope_dispatch_matter.
Summary generated from the project's README
About Scope MCP server
Scope provides specialized Model Context Protocol servers that allow AI assistants to interact with professional service networks. Developers can use these servers to dispatch work requests to credentialed human experts in the legal, insurance claims, and AEC sectors. The system retrieves real-time pricing by calculating costs directly from the published rate cards of the professionals involved.
Users can set up these servers locally using npm or via HTTP transport for clients like Claude Desktop, Claude Code, or Cursor. While a token is optional for read-only demo usage, a SCOPE_API_TOKEN is required for write operations. The legal server is currently live, while the insurance claims and AEC servers are in preview mode. The platform supports multi-tenant deployments through the SCOPE_ORG_SLUG environment variable to pin operations to a specific buyer organization.
What you can do with it
- 1Dispatch legal mattersSend a new legal matter to professionals to receive pricing based on their specific rate cards.
- 2Review daily briefingsRequest a summary of all currently open matters to stay updated on active work.
Written from the project's README. Every use case is checked against a quote from it.
How to install Scope MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Scope MCP in Claude Code
$ claude mcp add --env 'SCOPE_API_TOKEN=<YOUR_SCOPE_API_TOKEN>' scope-mcp-eae94b -- npx -y @jackgillen15-dev/scope-mcpInstall Scope MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"scope-mcp-eae94b": {
"command": "npx",
"args": [
"-y",
"@jackgillen15-dev/scope-mcp"
],
"env": {
"SCOPE_API_TOKEN": "<YOUR_SCOPE_API_TOKEN>"
}
}
}
}Install Scope MCP in VS Code
.vscode/mcp.json
{
"servers": {
"scope-mcp-eae94b": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jackgillen15-dev/scope-mcp"
],
"env": {
"SCOPE_API_TOKEN": "<YOUR_SCOPE_API_TOKEN>"
}
}
}
}Install Scope MCP in VS Code CLI
$ code --add-mcp '{"name":"scope-mcp-eae94b","type":"stdio","command":"npx","args":["-y","@jackgillen15-dev/scope-mcp"],"env":{"SCOPE_API_TOKEN":"<YOUR_SCOPE_API_TOKEN>"}}'Install Scope MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"scope-mcp-eae94b": {
"command": "npx",
"args": [
"-y",
"@jackgillen15-dev/scope-mcp"
],
"env": {
"SCOPE_API_TOKEN": "<YOUR_SCOPE_API_TOKEN>"
}
}
}
}Install Scope MCP in Codex
$ codex mcp add scope-mcp-eae94b --env 'SCOPE_API_TOKEN=<YOUR_SCOPE_API_TOKEN>' -- npx -y @jackgillen15-dev/scope-mcpInstall Scope MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.scope-mcp-eae94b] command = "npx" args = ["-y", "@jackgillen15-dev/scope-mcp"] [mcp_servers.scope-mcp-eae94b.env] SCOPE_API_TOKEN = "<YOUR_SCOPE_API_TOKEN>"
Install Scope MCP in Gemini CLI
$ gemini mcp add -s user -e 'SCOPE_API_TOKEN=<YOUR_SCOPE_API_TOKEN>' scope-mcp-eae94b npx -- -y @jackgillen15-dev/scope-mcpInstall Scope MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"scope-mcp-eae94b": {
"command": "npx",
"args": [
"-y",
"@jackgillen15-dev/scope-mcp"
],
"env": {
"SCOPE_API_TOKEN": "<YOUR_SCOPE_API_TOKEN>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @jackgillen15-dev/scope-mcp 0.1.1 in an isolated container with no network and no keys. It answered and listed 5 tools.
Scope MCP tools 5
Read from the server with tools/listscope_list_categoriesList the legal-services categories Scope can dispatch matters to. Each category has a slug, human label, and an indicator of whether vendors expose REST APIs (api_native) or are reached through Scope's ops-backed adapters (ops_backed).
scope_list_vendorsList Scope-verified vendors. Each result includes verified-reputation metrics (on-time %, budget variance, rework rate, completed matters, satisfaction) and credentialing summary. Vendor names are returned only for verified callers; anonymous callers get anonymized labels.
scope_dispatch_matterPost a new sealed-bid matter to Scope. Returns the matter id and status. Vendors in the matching category are notified; bids close after bid_window_minutes (default 4 days). Requires SCOPE_API_TOKEN. Use this when an AI workflow needs to engage a vendor on behalf of a firm - for example when a deposition notice arrives, when records retrieval is needed, or when a social media preservation request is triggered.
scope_get_matterLook up a matter by its display id (e.g. SC-2041) or UUID. Returns scope details, bids received, award status, and any deliverables. For sealed matters, vendor names are anonymized in returned bids until the matter is awarded.
scope_list_mattersList matters in flight for the calling buyer organization. Useful for status sweeps and pipeline reporting from inside an AI workflow.
| scope_list_categories | List the legal-services categories Scope can dispatch matters to. Each category has a slug, human label, and an indicator of whether vendors expose REST APIs (api_native) or are reached through Scope's ops-backed adapters (ops_backed). | |
| scope_list_vendors | List Scope-verified vendors. Each result includes verified-reputation metrics (on-time %, budget variance, rework rate, completed matters, satisfaction) and credentialing summary. Vendor names are returned only for verified callers; anonymous callers get anonymized labels. | |
| scope_dispatch_matter | Post a new sealed-bid matter to Scope. Returns the matter id and status. Vendors in the matching category are notified; bids close after bid_window_minutes (default 4 days). Requires SCOPE_API_TOKEN. Use this when an AI workflow needs to engage a vendor on behalf of a firm - for example when a deposition notice arrives, when records retrieval is needed, or when a social media preservation request is triggered. | |
| scope_get_matter | Look up a matter by its display id (e.g. SC-2041) or UUID. Returns scope details, bids received, award status, and any deliverables. For sealed matters, vendor names are anonymized in returned bids until the matter is awarded. | |
| scope_list_matters | List matters in flight for the calling buyer organization. Useful for status sweeps and pipeline reporting from inside an AI workflow. |
Configuration
SCOPE_API_TOKENSecretBearer token from scope-bid.vercel.app/settings. Required for write tools (scope_dispatch_matter). Read-only tools work without it on demo matters.
SCOPE_API_BASEBase URL of the Scope API. Defaults to the hosted instance.
SCOPE_ORG_SLUGPin reads/writes to a specific buyer organization. Useful for multi-tenant deployments.
| Name | Description | |
|---|---|---|
| SCOPE_API_TOKEN | Bearer token from scope-bid.vercel.app/settings. Required for write tools (scope_dispatch_matter). Read-only tools work without it on demo matters. | Secret |
| SCOPE_API_BASE | Base URL of the Scope API. Defaults to the hosted instance. | |
| SCOPE_ORG_SLUG | Pin reads/writes to a specific buyer organization. Useful for multi-tenant deployments. |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHub@scope-bid/scope-mcp
Engage credentialed professionals from inside your AI.
Model Context Protocol servers for Scope.bid professional dispatch across legal, insurance claims, and AEC services.
scope.bid | MCP Registry | npm | Plugin marketplace
What this is
Model Context Protocol servers that let AI assistants dispatch requests to credentialed human professionals and get back each professional's price, computed from their own published rate card.
@scope-bid/scope-mcp- legal services (live)@scope-bid/scope-claims-mcp- insurance claims (preview)@scope-bid/scope-aec-mcp- AEC (preview)
The servers are listed on Anthropic's official Model Context Protocol Registry under the DNS-verified namespaces bid.scope/legal, bid.scope/claims and bid.scope/aec.
Scope.bid is not affiliated with scope-bid.com, an unrelated laboratory equipment auction platform.
Install
npm install -g @scope-bid/scope-mcp
npm install -g @scope-bid/scope-claims-mcp
npm install -g @scope-bid/scope-aec-mcp
For most clients you do not need to install globally. Use npx -y @scope-bid/scope-mcp directly from your MCP client config.
Configure (Claude Desktop, Claude Code, Cursor)
{
"mcpServers": {
"scope-legal": {
"command": "npx",
"args": ["-y", "@scope-bid/scope-mcp"],
"env": {
"SCOPE_API_TOKEN": "your-token-here"
}
},
"scope-claims": {
"command": "npx",
"args": ["-y", "@scope-bid/scope-claims-mcp"],
"env": {
"SCOPE_API_TOKEN": "your-token-here"
}
}
}
}
For read-only demo usage the token is optional.
Or use HTTP transport (no install)
{
"mcpServers": {
"scope-legal": {
"type": "http",
"url": "https://scope.bid/api/mcp/legal",
"headers": { "Authorization": "Bearer your-token-here" }
}
}
}
HTTP endpoints:
Tools
Legal (bid.scope/legal):
scope_dispatch_matter- send a matter to professionals and get their rate-card pricesscope_briefing- daily briefing across all open mattersscope_get_matter,scope_list_matters,scope_list_categories,scope_list_vendors,scope_list_rosterscope_set_vendor_tier,scope_remove_from_roster,scope_award_matterscope_roster_audit,scope_vendor_health,scope_spend_rollup,scope_credential_alertsswp_clarify,swp_accept,swp_reject,swp_session_status- Scope Work Protocol tools for existing negotiation sessions (the session-opening tools are no longer served)
Claims (bid.scope/claims, preview): no live dispatch or award yet.
- npm package:
scope_claims_status,scope_claims_categories,scope_claims_join_waitlist,scope_reschedule_project - HTTP endpoint:
scope_claims_status,scope_claims_join_waitlist, and for a signed-in firmscope_briefing, read-only reporting tools and the deliverable tools (details)
AEC (bid.scope/aec, preview): no live dispatch or award yet.
- npm package:
scope_aec_status,scope_aec_categories,scope_aec_join_waitlist,scope_reschedule_project - HTTP endpoint: status, waitlist, categories, subcontractor dispatch and award, prequalification, bonding and safety record tools, plus
scope_briefing. In demo mode they answer with fictional sample data; for a signed-in firm onlyscope_briefingreturns live data (details)
Environment variables
SCOPE_API_BASE- override the default API base. Defaults tohttps://scope.bid.SCOPE_API_TOKEN- bearer token for write operations.SCOPE_ORG_SLUG- pin reads and writes to a specific buyer organization. Useful for multi-tenant deployments.
Plugin marketplace alternative
If you want bundled slash commands and skills along with the MCP server registration, install the plugin marketplace instead:
/plugin marketplace add github.com/scope-bid/scope-platform
/plugin install scope-legal
Evals
Canonical scenarios protect against regressions in MCP tool behavior.
Run locally against mocks:
npm run eval
Run against the live Anthropic API with MCP tools attached:
npm run eval:live
Add a new scenario any time a tool or skill ships that creates a new failure mode. Fixtures live in tests/evals/fixtures/, mocked tool responses in tests/evals/mocks/, runner in tests/evals/runner.ts. CI runs the mocked harness on every PR via .github/workflows/eval.yml.
Version bumps
When updating package.json version in any package directory, also update the matching server.json version. CI auto-syncs as a safety net but committed files should stay aligned for repo hygiene and local-publish testing.
Company
Scope Bid, Inc. is a Delaware C-corp founded May 2026 by Jack Gillen. San Diego, CA. Patent pending.
Scope MCP questions
How do I add Scope MCP to Claude Code?
Run claude mcp add --env 'SCOPE_API_TOKEN=<YOUR_SCOPE_API_TOKEN>' scope-mcp-eae94b -- npx -y @jackgillen15-dev/scope-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Scope MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Scope MCP provide?
It exposes 5 tools, including scope_list_categories, scope_list_vendors, scope_dispatch_matter, scope_get_matter, scope_list_matters.
What services can I dispatch through Scope?
You can dispatch requests across legal services, insurance claims, and AEC (Architecture, Engineering, and Construction) services.
How does the pricing work for professionals?
AI assistants can retrieve a professional's price, which is computed from their own published rate card.
Do I need an API token for demo usage?
No, the token is optional if you are using the server for read-only demo usage.