Developer Settings

API keys, endpoints, and integration configuration

API Key

Current Key

Keys use the gvl_ prefix and are SHA-256 hashed before storage.

Connection

API Endpoint

https://api.gavel.legal/v1

Network

Base Sepolia (Testnet)

Chain ID

84532

Escrow Token

USDC (Test)

MCP Server

Add to your Claude Desktop or agent MCP config:

{
  "mcpServers": {
    "gavel": {
      "command": "npx",
      "args": ["@gavel/mcp"],
      "env": {
        "GAVEL_API_URL": "...",
        "GAVEL_API_KEY": "gvl_..."
      }
    }
  }
}

API Endpoints

Method	Path	Description	Auth
POST	/v1/parties	Register party (get API key)	Public
POST	/v1/clauses	Register a DRC clause	Required
GET	/v1/clauses	List all clauses	Required
POST	/v1/disputes	File a new dispute	Required
GET	/v1/disputes	List disputes	Required
GET	/v1/disputes/:id	Get dispute details	Required
POST	/v1/disputes/:id/respond	Submit respondent response	Required
POST	/v1/disputes/:id/negotiate/propose	Submit settlement proposal	Required
POST	/v1/disputes/:id/evidence	Submit evidence	Required
POST	/v1/disputes/:id/escalate	Escalate to next tier	Required
GET	/v1/disputes/:id/award	Get arbitration award	Required
GET	/v1/disputes/:id/award/document	Generate award document	Required
POST	/v1/predict	Outcome prediction	Public
POST	/v1/webhooks	Register webhook	Required

MCP Tools

Tool	Description
gavel_file_dispute	File a new dispute under a registered clause
gavel_get_dispute	Retrieve dispute details by ID
gavel_list_disputes	List all disputes with pagination
gavel_submit_evidence	Submit evidence for a dispute
gavel_submit_proposal	Submit a settlement proposal
gavel_respond_to_dispute	Respond as the respondent party
gavel_escalate	Escalate dispute to the next resolution tier
gavel_get_award	Get the arbitration award for a dispute
gavel_get_events	Get the full audit trail for a dispute
gavel_register_clause	Register a new DRC clause

Webhooks

Receive real-time notifications for dispute events via HMAC-signed webhooks.

Webhook URL

Events

Payloads are signed with HMAC-SHA256. Verify the X-Gavel-Signature header.