# @scope-bid/scope-mcp

**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](https://scope.bid) | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=bid.scope) | [npm](https://www.npmjs.com/org/scope-bid) | [Plugin marketplace](https://github.com/scope-bid/scope-platform)

---

## 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:
- https://scope.bid/api/mcp/legal
- https://scope.bid/api/mcp/claims
- https://scope.bid/api/mcp/aec

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

## Company

Scope Bid, Inc. is a Delaware C-corp founded May 2026 by Jack Gillen. San Diego, CA. Patent pending.

LinkedIn: https://www.linkedin.com/company/scope-bid/