Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

claude mcp add --transport http shelf-smoke https://shelf.kymac.co/mcp --header "Authorization: Bearer ${SHELF_SMOKE_TOKEN}" --header "X-API-Key: ${X_API_KEY}"

[mcp_servers.shelf-smoke]
url = "https://shelf.kymac.co/mcp"
bearer_token_env_var = "SHELF_SMOKE_TOKEN"
env_http_headers = { "X-API-Key" = "X_API_KEY" }

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

{
  "mcpServers": {
    "shelf-smoke": {
      "type": "http",
      "url": "https://shelf.kymac.co/mcp",
      "headers": {
        "Authorization": "Bearer ${SHELF_SMOKE_TOKEN}",
        "X-API-Key": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=shelf-smoke&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vc2hlbGYua3ltYWMuY28vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7U0hFTEZfU01PS0VfVE9LRU59IiwiWC1BUEktS2V5IjoiJHtYX0FQSV9LRVl9In19"
}

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

{
  "mcpServers": {
    "shelf-smoke": {
      "httpUrl": "https://shelf.kymac.co/mcp",
      "headers": {
        "Authorization": "Bearer ${SHELF_SMOKE_TOKEN}",
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

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

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

Quality 87 / 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 carries no ttlMs, so clients re-fetch it

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: confirm_credits (idempotentHint, openWorldHint); smoke (idempotentHint, openWorldHint); issue_key (idempotentHint, openWorldHint); …
pass
tools.token_costabout 1,033 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool history not recorded yet

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

12 tools, about 1,033 tokens to load them all · tool set 60b0ef339893 · checked 2026-10-19 10:52 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://shelf.kymac.co/mcp` streamable-http	none	no (11 failures)	61%	211 ms	2026-07-28	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, optional credit.balance_snapshot.
`health`read-only	Public readiness (GET /health): billing (test\|live\|gated) and runner_ready. No key.
`issue_key`	Mint a caller key (POST /keys). Bot install starts at GET https://shelf.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 smoke.
`list_credit_packs`read-only	Prepaid TEST packs (GET /credits/packs). checkout_credits is intent only; credits grant after confirm_credits.
`quote_credits`read-only	Dry-run cost for an op without debit (GET /credits/quote?op=smoke). 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.
`smoke`read-only	Headless smoke (POST /smoke). Install via GET https://shelf.kymac.co/llms.txt only. Prefer Authorization: Bearer; X-API-Key is an alias. Golden URL https://example.com/ — 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=smoke_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.
`verify_key`read-only	Confirm SHELF_SMOKE_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.shelf/shelf-smoke",
  "title": "shelf-smoke — url smoke / headless QA",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://shelf.kymac.co/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Bearer ssm_… from POST /keys (or X-API-Key). Env SHELF_SMOKE_API_KEY also works for stdio."
        },
        {
          "name": "X-API-Key",
          "isSecret": true,
          "description": "Alternate to Authorization. Mint via POST /keys."
        }
      ]
    }
  ],
  "version": "0.3.0",
  "websiteUrl": "https://shelf.kymac.co/llms.txt",
  "description": "url smoke / headless QA: desktop+phone → pass/fail JSON. MCP shelf.kymac.co"
}