{
  "mcp_url": "https://www.rightshold.com/mcp",
  "sse_url": "https://www.rightshold.com/sse",
  "transport": "Streamable HTTP, stateless JSON (no session to keep). Clients that only speak the older SSE transport use the sse_url.",
  "key": "Read-only checks need no key. For account tools, keep the key in the RIGHTSHOLD_API_KEY environment variable (or the client's own secret field); every setting below reads it from there and sends it as Authorization: Bearer.",
  "no_key_needed_for": "check_license, check_rights_batch, license_compatibility, attribution_string, read_ai_policy, ask_rightshold, kya_check, gate_check, registry_lookup and every verify tool",
  "clients": {
    "grok": {
      "client": "Grok (grok.com)",
      "steps": "Open grok.com/connectors, choose New Connector, then Custom, and enter the URL.",
      "url": "https://www.rightshold.com/mcp",
      "note": "Read-only tools need no sign-in. On Grok Business or Enterprise, a team admin adds the connector first."
    },
    "grok_bot": {
      "client": "Grok Bot",
      "steps": "Add a custom MCP server from Connect apps; choose Remote HTTPS when it should send your key.",
      "url": "https://www.rightshold.com/mcp",
      "header": {
        "Authorization": "Bearer ${RIGHTSHOLD_API_KEY}"
      }
    },
    "grok_cli": {
      "client": "Grok Build (CLI)",
      "command": "grok mcp add --transport http rightshold https://www.rightshold.com/mcp --header \"Authorization: Bearer ${RIGHTSHOLD_API_KEY}\""
    },
    "xai_api": {
      "client": "xAI API (Responses, remote MCP)",
      "endpoint": "POST https://api.x.ai/v1/responses",
      "tool": {
        "type": "mcp",
        "server_url": "https://www.rightshold.com/mcp?toolset=checks",
        "server_label": "rightshold",
        "server_description": "License checks, AI-policy reads and agent verification"
      },
      "with_key": {
        "type": "mcp",
        "server_url": "https://www.rightshold.com/mcp?toolset=proof",
        "server_label": "rightshold",
        "headers": {
          "Authorization": "Bearer <RIGHTSHOLD_API_KEY>"
        }
      },
      "python": "from xai_sdk.tools import mcp\nrightshold = mcp(server_url=\"https://www.rightshold.com/mcp?toolset=checks\", server_label=\"rightshold\")"
    },
    "claude_ai": {
      "client": "Claude (claude.ai and Claude Desktop)",
      "steps": "Customize, then Connectors, then + Add, then Add custom connector; enter the URL with no sign-in.",
      "url": "https://www.rightshold.com/mcp",
      "note": "Team and Enterprise owners add it under Organization settings, Connectors. Where the dialog offers request headers, add Authorization with the value Bearer and your key."
    },
    "claude_code": {
      "client": "Claude Code",
      "command": "claude mcp add --transport http rightshold https://www.rightshold.com/mcp --header \"Authorization: Bearer ${RIGHTSHOLD_API_KEY}\"",
      "mcp_json": {
        "mcpServers": {
          "rightshold": {
            "type": "http",
            "url": "https://www.rightshold.com/mcp",
            "headers": {
              "Authorization": "Bearer ${RIGHTSHOLD_API_KEY}"
            }
          }
        }
      }
    },
    "cursor": {
      "client": "Cursor (~/.cursor/mcp.json or .cursor/mcp.json)",
      "config": {
        "mcpServers": {
          "rightshold": {
            "url": "https://www.rightshold.com/mcp",
            "headers": {
              "Authorization": "Bearer ${env:RIGHTSHOLD_API_KEY}"
            }
          }
        }
      },
      "note": "Drop headers for read-only use."
    },
    "vscode": {
      "client": "VS Code (.vscode/mcp.json)",
      "config": {
        "servers": {
          "rightshold": {
            "type": "http",
            "url": "https://www.rightshold.com/mcp",
            "headers": {
              "Authorization": "Bearer ${env:RIGHTSHOLD_API_KEY}"
            }
          }
        }
      }
    },
    "chatgpt": {
      "client": "ChatGPT (web)",
      "steps": "Open ChatGPT Plugins, choose +, then Add custom MCP server; enter the URL and choose No authentication.",
      "url": "https://www.rightshold.com/mcp",
      "note": "This gives the read-only tools; ChatGPT on the web does not send API keys, so account tools need the desktop app or the API."
    },
    "chatgpt_desktop": {
      "client": "ChatGPT desktop and Codex (config.toml)",
      "config_toml": "[mcp_servers.rightshold]\nurl = \"https://www.rightshold.com/mcp\"\nbearer_token_env_var = \"RIGHTSHOLD_API_KEY\""
    },
    "openai_api": {
      "client": "OpenAI Responses API (remote MCP)",
      "tool": {
        "type": "mcp",
        "server_label": "rightshold",
        "server_url": "https://www.rightshold.com/mcp",
        "require_approval": {
          "never": {
            "tool_names": [
              "start_here",
              "check_license",
              "check_rights_batch",
              "license_compatibility",
              "attribution_string",
              "read_ai_policy",
              "ask_rightshold",
              "kya_check",
              "kya_lookup",
              "kya_verify",
              "gate_check",
              "registry_lookup",
              "verify_rights_receipt",
              "verify_rights_manifest",
              "ledger_verify",
              "get_pricing"
            ]
          }
        },
        "headers": {
          "Authorization": "Bearer <RIGHTSHOLD_API_KEY>"
        }
      },
      "note": "Read-only tools run without approval; signups and signed proofs still ask. Drop headers for read-only use."
    },
    "generic": {
      "client": "Any MCP client",
      "url": "https://www.rightshold.com/mcp",
      "transport": "streamable-http",
      "header": "Authorization: Bearer <RIGHTSHOLD_API_KEY>",
      "toolsets": "https://www.rightshold.com/mcp?toolset=checks (read-only), ?toolset=proof (signed proof), ?toolset=all"
    }
  },
  "next_action": {
    "action": "first_check",
    "label": "Run your first check",
    "why": "check_license answers in one call, free, no key.",
    "needs": "nothing",
    "tool": "start_here",
    "rest": "GET https://www.rightshold.com/v1/licenses/check?license=CC-BY-NC-4.0&use=commercial_use"
  }
}