protogrid

Search / tools.ref/ref-tools-mcp

ref-tools-mcp

R2· OAuth, once

Token-efficient search for coding agents over public and private documentation.

v3.0.1 · active · repository · 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.
Quality100strong
Trust78of 100
Uptime, 30 days100%
Latency p50435 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "ref-tools-mcp": {
      "type": "http",
      "url": "https://api.ref.tools/mcp"
    }
  }
}
claude mcp add --transport http ref-tools-mcp https://api.ref.tools/mcp
[mcp_servers.ref-tools-mcp]
url = "https://api.ref.tools/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ref-tools-mcp": {
      "type": "remote",
      "url": "https://api.ref.tools/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "ref-tools-mcp": {
      "type": "http",
      "url": "https://api.ref.tools/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ref-tools-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLnJlZi50b29scy9tY3AifQ%3D%3D"
}
{
  "servers": {
    "ref-tools-mcp": {
      "type": "http",
      "url": "https://api.ref.tools/mcp"
    }
  }
}
{
  "mcpServers": {
    "ref-tools-mcp": {
      "httpUrl": "https://api.ref.tools/mcp"
    }
  }
}
extensions:
  "ref-tools-mcp":
    enabled: true
    name: "ref-tools-mcp"
    type: streamable_http
    uri: "https://api.ref.tools/mcp"
    timeout: 300

Quality 100 / 100strong

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 hygienen/a · weight 30
  • n/a
    tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool list unknown
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

Tool list unknown · checked 2026-10-20 10:35 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 78 / 100

duplicate-repo
provenance75
liveness100
freshness45
hygiene80

+repository +dns-namespace +reachable +uptime-100% -stale-357d -duplicate-repo(3 names)

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://api.ref.tools/mcp streamable-httpoauth2 AS: https://ref.scalekit.com/resources/res_100246322321295106yes100%435 ms–2026-10-20

Tools (0)

No tools observed. Tools appear once a credential-free probe can list them.

Schemas: list_tools.

Also listed as

2 other active names share this repository: ai.smithery/ref-tools-ref-tools-mcp, io.github.ref-tools/ref-tools-mcp

Similar MCP servers

Official server.json
{
  "name": "tools.ref/ref-tools-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
  "remotes": [
    {
      "url": "https://api.ref.tools/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-Ref-Api-Key",
          "description": "API key for authentication"
        }
      ]
    }
  ],
  "version": "3.0.1",
  "repository": {
    "url": "https://github.com/ref-tools/ref-tools-mcp",
    "source": "github"
  },
  "description": "Token-efficient search for coding agents over public and private documentation."
}