protogrid

Search / io.github.cameron-creations/numberbroom-mcp

numberbroom-mcp

R2· OAuth, once

Verify US phone numbers: line type, carrier, and TCPA litigator status via the NumberBroom API.

v1.0.1 · active · repository · website · descriptor JSON · versions

An agent can connect after a one-time OAuth consent by a human.Remote endpoint behind OAuth 2. Tokens stay with the agent; the registry only exposes the authorization metadata.
Quality86good
Trust94of 100
Uptime, 30 days97%
Latency p50316 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "numberbroom-mcp": {
      "type": "http",
      "url": "https://numberbroom.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NUMBERBROOM_MCP_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http numberbroom-mcp https://numberbroom.com/mcp --header "Authorization: Bearer ${NUMBERBROOM_MCP_TOKEN}"
[mcp_servers.numberbroom-mcp]
url = "https://numberbroom.com/mcp"
bearer_token_env_var = "NUMBERBROOM_MCP_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "numberbroom-mcp": {
      "type": "remote",
      "url": "https://numberbroom.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:NUMBERBROOM_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "numberbroom-mcp": {
      "type": "http",
      "url": "https://numberbroom.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NUMBERBROOM_MCP_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=numberbroom-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbnVtYmVyYnJvb20uY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke05VTUJFUkJST09NX01DUF9UT0tFTn0ifX0%3D"
}
{
  "servers": {
    "numberbroom-mcp": {
      "type": "http",
      "url": "https://numberbroom.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NUMBERBROOM_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "numberbroom-mcp": {
      "httpUrl": "https://numberbroom.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NUMBERBROOM_MCP_TOKEN}"
      }
    }
  }
}
extensions:
  "numberbroom-mcp":
    enabled: true
    name: "numberbroom-mcp"
    type: streamable_http
    uri: "https://numberbroom.com/mcp"
    headers:
      "Authorization": "Bearer ${NUMBERBROOM_MCP_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${NUMBERBROOM_MCP_TOKEN}. The registry never accepts secret values.

Quality 86 / 100good

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorization100 · weight 15
  • pass
    auth.prmProtected Resource Metadata (RFC 9728) published
  • pass
    auth.as_metadataauthorization server metadata reachable
  • pass
    auth.cimdClient ID Metadata Documents supported
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: verify_phone_number (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_credit_balance (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
  • pass
    tools.token_costabout 263 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

2 tools, about 263 tokens to load them all · tool set 4c5f407f46d7 · checked 2026-10-19 16:20 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90
liveness99
freshness85
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-97% ~updated-35d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://numberbroom.com/mcp streamable-httpoauth2 AS: https://numberbroom.comyes97%316 ms–2026-10-19

Tools (2)

get_credit_balanceCheck the remaining pre-paid API credit balance for the connected NumberBroom account. Free to call — does not spend credits.
verify_phone_numberVerify a single US phone number: carrier-level line type (mobile, landline, VoIP, toll-free or other), carrier name, an activity score with a likely-disconnected flag (a dead mobile still reports as mobile, so read isLikelyDisconnected, not lineType), and whether the number is a known TCPA litigator. Does not check Do Not Call registries. Costs $0.20, charged against the caller's NumberBroom API credit balance — a number that fails to parse as a phone number is not charged. Get an API key at https://numberbroom.com/settings.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.cameron-creations/numberbroom-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://numberbroom.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Your NumberBroom API key as a Bearer token: \"Bearer nb_live_...\". Get one at https://numberbroom.com/settings."
        }
      ]
    }
  ],
  "version": "1.0.1",
  "repository": {
    "url": "https://github.com/cameron-creations/numberbroom-mcp",
    "source": "github"
  },
  "websiteUrl": "https://numberbroom.com/mcp-server",
  "description": "Verify US phone numbers: line type, carrier, and TCPA litigator status via the NumberBroom API."
}