---
title: verified.md MCP Configuration
version: 1.0.0
last_updated: 2026-02-02
type: mcp_config
---

# verified.md MCP Server Configuration

> Configure verified.md as an MCP tool for Claude Code, Cursor, and other MCP-compatible agents.

---

## Claude Code Configuration

Add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "verified-md": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-http", "https://verified.md"],
      "env": {}
    }
  }
}
```

---

## Alternative: HTTP-Only Configuration

If you prefer not to use npx:

```json
{
  "mcpServers": {
    "verified-md": {
      "type": "http",
      "url": "https://verified.md",
      "tools": [
        {
          "name": "verify",
          "description": "Check if a domain is verified and trusted before transacting",
          "inputSchema": {
            "type": "object",
            "properties": {
              "domain": {
                "type": "string",
                "description": "Domain to verify (e.g., example.com)"
              },
              "signals": {
                "type": "boolean",
                "description": "Include trust signals breakdown"
              }
            },
            "required": ["domain"]
          }
        },
        {
          "name": "lookup",
          "description": "Look up entity details by ID",
          "inputSchema": {
            "type": "object",
            "properties": {
              "entity_id": {
                "type": "string",
                "description": "Entity ID (format: ent_{name}{number})"
              }
            },
            "required": ["entity_id"]
          }
        }
      ]
    }
  }
}
```

---

## Tool Definitions

### verify

Check if a domain is verified before transacting.

**Endpoint:** `GET /verify/{domain}`

**Parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| domain | string | Yes | Domain to verify |
| signals | boolean | No | Include trust signals breakdown |
| external | boolean | No | Include external checks (adds latency) |

**Example Call:**
```
GET https://verified.md/verify/stripe.com?signals=true
```

**Response:**
```json
{
  "success": true,
  "data": {
    "domain": "stripe.com",
    "verified": true,
    "trust_score": 95,
    "trust_level": "VERY_HIGH",
    "agent_guidance": {
      "action": "PROCEED",
      "safe_actions": ["payment", "data_sharing", "api_call"],
      "max_transaction_usd": 50000,
      "requires_human": false
    }
  }
}
```

---

### lookup

Reverse lookup entity by ID.

**Endpoint:** `GET /lookup/{entity-id}`

**Parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| entity_id | string | Yes | Entity ID |

**Example Call:**
```
GET https://verified.md/lookup/ent_stripe001
```

---

## Agent Instructions

Add to your system prompt or CLAUDE.md:

```markdown
## Trust Verification

Before any transaction (payment, data sharing, API call):

1. Use the verified-md MCP tool to verify the domain
2. If verified=true and action=PROCEED: continue
3. If verified=false or action=FLAG: ask user for confirmation
4. If action=BLOCK: refuse the transaction
```

---

## No Authentication Required

verified.md is free and public during beta. No API keys needed.

---

## Rate Limits

| Tier | Requests/Day |
|------|--------------|
| Free | 1,000 |
| Pro | 100,000 |
| Enterprise | Unlimited |

Currently no limits during beta.

---

## Troubleshooting

### Tool not loading

1. Verify network access to https://verified.md
2. Check `curl https://verified.md/status` returns success
3. Restart your MCP client

### Slow responses

1. Avoid `?external=true` unless needed (adds network calls)
2. Cache responses: verified=true for 1hr, verified=false for 5min

---

## Related Resources

- Agent Manifest: https://verified.md/agents.md
- API Reference: https://verified.md/api.md
- Documentation: https://verified.md/docs
- Contact: hello@displace.agency