protogrid

Search / io.github.djrobson5/agentmd

AgentMD

R1· needs a key

Convert PDF, DOCX, HTML, and URLs to clean, LLM-ready markdown with tables preserved

v0.1.4 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds AGENTMD_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality86good
Trust94of 100
Uptime, 30 days100%
Latency p50236 ms

Connect

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

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

Quality 86 / 100good

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • 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: convert_url_to_markdown (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); convert_document_to_markdown (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
  • pass
    tools.token_costabout 831 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
dependencies100 · weight 15
  • pass
    deps.known_vulnsno known advisory in 4 resolved packages
  • pass
    deps.mcp_sdk_version@modelcontextprotocol/server 2.1.0, no known advisory
  • pass
    deps.resolvable[email protected] resolved: 4 packages

2 tools, about 831 tokens to load them all · tool set 498e99d559ba · checked 2026-10-20 12:45 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
liveness100
freshness85
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-34d-ago

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

Dependencies

[email protected] npm3 dependencies, resolved · MCP SDK @modelcontextprotocol/server 2.1.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://www.getagentmd.com/api/mcp streamable-httpapi_key ${AGENTMD_TOKEN}yes100%236 ms2026-07-282026-10-20
packageregistryversionruntimesecrets
agentmd-mcpnpm0.1.4–AGENTMD_API_KEY

Tools (2)

convert_document_to_markdownConvert a document you already have (PDF, DOCX, HTML, plain text) to clean, LLM-ready markdown. Pass the file contents as base64. Supports reading only part of a large document: PDF page ranges, a heading outline, a single section, or a token cap.
convert_url_to_markdownFetch a URL (web page, PDF, DOCX, etc.) and convert it to clean, LLM-ready markdown. Extracts the main article content from web pages and preserves tables. Supports reading only part of a large document: PDF page ranges, a heading outline, a single section, or a token cap.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.djrobson5/agentmd",
  "icons": [
    {
      "src": "https://www.getagentmd.com/icon-512.png",
      "sizes": [
        "512x512"
      ],
      "mimeType": "image/png"
    },
    {
      "src": "https://www.getagentmd.com/icon-64.png",
      "sizes": [
        "64x64"
      ],
      "mimeType": "image/png"
    }
  ],
  "title": "AgentMD",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://www.getagentmd.com/api/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer <your AgentMD API key>"
        }
      ]
    }
  ],
  "version": "0.1.4",
  "packages": [
    {
      "version": "0.1.4",
      "transport": {
        "type": "stdio"
      },
      "identifier": "agentmd-mcp",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "AGENTMD_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "API key from https://www.getagentmd.com"
        },
        {
          "name": "AGENTMD_BASE_URL",
          "description": "Override the API base URL (self-hosting or staging)"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/djrobson5/agentmd-mcp",
    "source": "github"
  },
  "websiteUrl": "https://www.getagentmd.com",
  "description": "Convert PDF, DOCX, HTML, and URLs to clean, LLM-ready markdown with tables preserved"
}