Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "pdf-text": {
      "type": "http",
      "url": "https://pdf.kymac.co/mcp",
      "headers": {
        "Authorization": "Bearer ${PDF_TEXT_TOKEN}",
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

claude mcp add --transport http pdf-text https://pdf.kymac.co/mcp --header "Authorization: Bearer ${PDF_TEXT_TOKEN}" --header "X-API-Key: ${X_API_KEY}"

[mcp_servers.pdf-text]
url = "https://pdf.kymac.co/mcp"
bearer_token_env_var = "PDF_TEXT_TOKEN"
env_http_headers = { "X-API-Key" = "X_API_KEY" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pdf-text": {
      "type": "remote",
      "url": "https://pdf.kymac.co/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:PDF_TEXT_TOKEN}",
        "X-API-Key": "{env:X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "pdf-text": {
      "type": "http",
      "url": "https://pdf.kymac.co/mcp",
      "headers": {
        "Authorization": "Bearer ${PDF_TEXT_TOKEN}",
        "X-API-Key": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=pdf-text&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcGRmLmt5bWFjLmNvL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1BERl9URVhUX1RPS0VOfSIsIlgtQVBJLUtleSI6IiR7WF9BUElfS0VZfSJ9fQ%3D%3D"
}

{
  "servers": {
    "pdf-text": {
      "type": "http",
      "url": "https://pdf.kymac.co/mcp",
      "headers": {
        "Authorization": "Bearer ${PDF_TEXT_TOKEN}",
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "pdf-text": {
      "httpUrl": "https://pdf.kymac.co/mcp",
      "headers": {
        "Authorization": "Bearer ${PDF_TEXT_TOKEN}",
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

extensions:
  "pdf-text":
    enabled: true
    name: "pdf-text"
    type: streamable_http
    uri: "https://pdf.kymac.co/mcp"
    headers:
      "Authorization": "Bearer ${PDF_TEXT_TOKEN}"
      "X-API-Key": "${X_API_KEY}"
    timeout: 300

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

Quality 85 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

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 hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations12 of 12 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: rotate_key (idempotentHint, openWorldHint); revoke_key (idempotentHint, openWorldHint); list_credit_packs (idempotentHint, openWorldHint); …
pass
tools.token_costabout 1,067 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

12 tools, about 1,067 tokens to load them all · tool set 653db0292cc4 · checked 2026-10-20 11:08 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 50 / 100

no-repositoryunreachable

provenance55

liveness0

freshness85

hygiene80

+dns-namespace +website -unreachable(11 failures) ~updated-32d-ago -no-repository

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

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://pdf.kymac.co/mcp` streamable-http	none	no (11 failures)	59%	376 ms	2025-03-26	2026-09-23

Tools (12)

`checkout_credits`	Stripe TEST PaymentIntent for a pack (POST /credits/checkout). Intent only — returns credits_pending; credits are not granted or spendable until confirm_credits succeeds. Requires a caller key.
`confirm_credits`	Confirm a TEST PaymentIntent with Stripe test card pm_card_visa (POST /credits/confirm). This is when credits become granted/spendable (appends credit.purchase with credits_added). TEST only.
`credit_balance`read-only	Derived prepaid balance for this caller_id (GET /credits/balance).
`credit_events`read-only	Append-only Ledger events for this caller_id (GET /credits/events): credit.grant (first_key), credit.purchase, credit.debit (pdf_success), optional credit.balance_snapshot.
`health`read-only	Public readiness (GET /health): billing (test\|gated) and runner_ready. No key.
`issue_key`	Mint a caller key (POST /keys). Bot install starts at GET https://pdf.kymac.co/llms.txt (sole advertised entry). Secret ssm_… is returned once. Prefer Authorization: Bearer; X-API-Key is an alias. First issue grants 1 free credit (credit.grant reason=first_key). Quote cost with quote_credits before pdf_extract.
`list_credit_packs`read-only	Prepaid TEST packs (GET /credits/packs). checkout_credits is intent only; credits grant after confirm_credits.
`pdf_extract`read-only	Text-layer PDF extract (POST /pdf). Install via GET https://pdf.kymac.co/llms.txt only. Prefer Authorization: Bearer; X-API-Key is an alias. Golden URL https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf — compare ok true/false JSON in llms.txt. First key includes 1 free credit. Quote first with quote_credits (no debit). Debits 1 credit on ok:true (credit.debit reason=pdf_success). 200 bodies include credits_burned and credits_remaining. HTTP fails use code/message/retryable/next (error aliases message). 401 next=refresh key. 402: code=insufficient_credits, retryable=false, next=buy credits. Retryable fails use next=retry. No OCR.
`quote_credits`read-only	Dry-run cost for an op without debit (GET /credits/quote?op=pdf). Returns cost, balance, and would_succeed.
`revoke_key`destructive	Invalidate the presented secret (POST /keys/revoke). Same id is revoked; old secret then fails 401 invalid_api_key. Prefer Authorization: Bearer; X-API-Key is an alias only. No ops file-edit.
`rotate_key`	Replace the presented secret (POST /keys/rotate). Same id/caller_id and credits. New ssm_… is returned once. Old secret then fails 401 invalid_api_key. Prefer Authorization: Bearer; X-API-Key is an alias only. No ops file-edit.
`verify_key`read-only	Confirm PDF_TEXT_API_KEY or Authorization: Bearer (GET /keys/verify). X-API-Key is an alias only. Does not echo the secret.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "co.kymac.pdf/pdf-text",
  "title": "pdf-text",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://pdf.kymac.co/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Bearer ssm_… from POST /keys."
        },
        {
          "name": "X-API-Key",
          "isSecret": true,
          "description": "Alternate to Authorization."
        }
      ]
    }
  ],
  "version": "0.4.0",
  "websiteUrl": "https://pdf.kymac.co/llms.txt",
  "description": "PDF URL → extracted text for bots. Free try then prepaid TEST. https://pdf.kymac.co"
}