Get your first verdict in 5 minutes.

1 Connect via MCP (no install)

The fastest path: add the MCP server to your client config. No SDK, no install, no API key required for the hosted endpoint.

Claude Desktop / Cursor / VS Code

{
  "mcpServers": {
    "collar-guardrail": {
      "url": "https://api.collarguardrail.com/mcp-http/mcp"
    }
  }
}

2 Verify the connection

Before wiring this into an agent, confirm the endpoint responds.

curl -X POST https://api.collarguardrail.com/mcp-http/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

You should get a JSON response listing the five tools. If you get a 400, make sure the Accept header includes both application/json and text/event-stream.

3 Run your first trade check

Call evaluate_trade with a wallet, asset, side, and amount. The verdict is deterministic — same input, same verdict, every time.

curl -X POST https://api.collarguardrail.com/mcp-http/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "evaluate_trade",
      "arguments": {
        "wallet": "0x1234567890abcdef1234567890abcdef12345678",
        "asset": "NVDA",
        "contract_address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
        "side": "buy",
        "amount": 1
      }
    },
    "id": 1
  }'

What you get back

4 Use it from LangChain (Python)

If you are building in Python, the langchain-collar package wraps all five tools as native LangChain tools.

pip install langchain-collar

from langchain_collar import get_tools
from langchain.agents import create_agent

tools = get_tools()
agent = create_agent("gpt-4o", tools)

result = agent.invoke({
    "messages": [{
        "role": "user",
        "content": "Check a 10 NVDA buy from wallet 0x... before signing."
    }]
})

Or call a tool directly:

from langchain_collar import evaluate_trade

verdict = evaluate_trade.invoke({
    "wallet": "0x1234567890abcdef1234567890abcdef12345678",
    "asset": "NVDA",
    "contract_address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
    "side": "buy",
    "amount": 10.0,
})
print(verdict)

5 Go beyond Tier 1 (optional)

The MCP endpoint is fixed at Tier 1 ($5,000 notional). For higher limits ($25K / $100K), use the REST API with wallet-signature auth.

Authentication uses EIP-191 wallet signatures — no gas, no spending approval, no private key handling. Full flow is in the agent docs.