@scope-bid/scope-mcp

Name: Scope (AEC) - Preview
Author: scope

Hire your next vendor through 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

Three 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 vertical (court reporters, IMEs, records, experts, e-discovery, translation, mediators, trial graphics, foreign-jurisdiction counsel, more)
@scope-bid/scope-claims-mcp - insurance claims (IMEs, surveillance, peer review, voc rehab, life-care plans, defense medical record review)
@scope-bid/scope-aec-mcp - AEC (subcontractor prequal, bonding, safety records, dispatch)

Scope.bid is the first vertical-services MCP platform on Anthropic's official Model Context Protocol Registry. Three namespaces are claimed under DNS-verified bid.scope/* (legal, claims, AEC). Two are reserved (healthcare, pharma).

Scope.bid is not affiliated with scope-bid.com, an unrelated laboratory equipment auction platform.

Install

bash

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)

json

{
  "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)

json

{
  "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 prices
scope_briefing - daily briefing across all open matters
scope_get_matter, scope_list_matters, scope_list_categories, scope_list_vendors, scope_list_roster
scope_set_vendor_tier, scope_remove_from_roster, scope_award_matter
scope_roster_audit, scope_vendor_health, scope_spend_rollup, scope_credential_alerts
swp_clarify, swp_accept, swp_reject, swp_session_status - Scope Work Protocol tools for existing negotiation sessions (the session-opening tools were retired at the rate-card cutover and are no longer served)

Claims (bid.scope/claims): IME routing, surveillance coordination, defense medical record review, life-care planning, voc rehab routing, roster audit, credential alerts.

AEC (bid.scope/aec): subcontractor dispatch, prequalification, bonding capacity, safety record pulls, AEC vendor listing.

Environment variables

SCOPE_API_BASE - override the default API base. Defaults to https://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

Five canonical scenarios protect against regressions in MCP tool behavior.

Run locally against mocks:

bash

npm run eval

Run against the live Anthropic API with MCP tools attached:

bash

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.