Servidor MCP
O Model Context Protocol (MCP) permite que agentes de IA e assistentes de IDE chamem ferramentas. O servidor do ecdsa.com dá a eles as operações da API e os catálogos de referência do site, para que um assistente possa verificar uma assinatura ou explicar um erro de TLS em vez de adivinhar.
Endpoint
https://ecdsa.com/api/mcpStreamable HTTP, sem estado — sem sessões e nada para instalar. Funciona com qualquer cliente MCP que se conecte a servidores remotos.
Não é preciso chave de API: toda ferramenta funciona de forma anônima. As chaves de API, quando forem lançadas junto com as contas, fazem as chamadas passarem do limite por IP para o limite próprio da chave.
Conectar um cliente
Claude Code
O primeiro comando adiciona o servidor para você; com --scope project, ele vai para o arquivo .mcp.json do repositório e funciona para todos que abrirem o projeto.
claude mcp add --transport http ecdsa https://ecdsa.com/api/mcp
claude mcp add --transport http ecdsa --scope project https://ecdsa.com/api/mcp{
"mcpServers": {
"ecdsa": {
"type": "http",
"url": "https://ecdsa.com/api/mcp"
}
}
}Com uma chave de API
Para quando as chaves de API estiverem disponíveis. Mantenha a chave fora dos arquivos que entram nos seus commits.
Adicione a chave no escopo local, onde ela fica na sua máquina: uma entrada local substitui a compartilhada de mesmo nome, só para você.
claude mcp add --transport http ecdsa https://ecdsa.com/api/mcp \
--header "Authorization: Bearer ecdsa_live_…"Claude Desktop e claude.ai
Personalizar → Conectores → Adicionar → Adicionar conector personalizado. URL https://ecdsa.com/api/mcp, autenticação: sem login. Os conectores pertencem à sua conta do Claude, então um conector adicionado no claude.ai também funciona no Claude Desktop; o plano gratuito permite um conector personalizado.
Com uma chave de API
Para quando as chaves de API estiverem disponíveis. Mantenha a chave fora dos arquivos que entram nos seus commits.
Onde a caixa de diálogo do conector oferecer cabeçalhos de requisição, adicione Authorization com o valor Bearer ecdsa_live_…; onde ainda não oferecer, use a ponte stdio abaixo com a opção --header. Os conectores fazem as chamadas a partir da nuvem da Anthropic, então, sem chave, todos os usuários deles compartilham uma única cota por IP.
Cursor
Em ~/.cursor/mcp.json para todos os projetos, ou em .cursor/mcp.json para um só:
{
"mcpServers": {
"ecdsa": {
"url": "https://ecdsa.com/api/mcp"
}
}
}Com uma chave de API
Para quando as chaves de API estiverem disponíveis. Mantenha a chave fora dos arquivos que entram nos seus commits.
Para uma chave, prefira o arquivo global. O Cursor preenche ECDSA_API_KEY a partir do ambiente, então a variável precisa estar definida.
{
"mcpServers": {
"ecdsa": {
"url": "https://ecdsa.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:ECDSA_API_KEY}"
}
}
}
}VS Code
No arquivo .vscode/mcp.json do espaço de trabalho ou pela linha de comando:
{
"servers": {
"ecdsa": {
"type": "http",
"url": "https://ecdsa.com/api/mcp"
}
}
}code --add-mcp '{"name":"ecdsa","type":"http","url":"https://ecdsa.com/api/mcp"}'Com uma chave de API
Para quando as chaves de API estiverem disponíveis. Mantenha a chave fora dos arquivos que entram nos seus commits.
O VS Code pede a chave na primeira vez que o servidor inicia e a guarda no próprio armazenamento de segredos.
{
"inputs": [
{
"type": "promptString",
"id": "ecdsa-api-key",
"description": "ecdsa.com API key",
"password": true
}
],
"servers": {
"ecdsa": {
"type": "http",
"url": "https://ecdsa.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:ecdsa-api-key}"
}
}
}
}Clientes que só usam stdio
Conecte-os ao servidor remoto pela ponte mcp-remote:
{
"mcpServers": {
"ecdsa": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://ecdsa.com/api/mcp"
]
}
}
}Ferramentas
O servidor lista 11 ferramentas; a lista é lida aqui do próprio registro do servidor — a mesma que tools/list retorna.
verify_signatureVerify an ECDSA signatureVerifies a signature over a message (or a precomputed digest) against a public key. Curves: P-256, P-384, P-521, secp256k1. Signature formats auto-detected: ASN.1 DER or raw r‖s, in hex, base64 or base64url. Public key formats: PEM SPKI ("PUBLIC KEY"), EC JWK, or a bare SEC1 point in hex/base64. A signature that simply does not verify returns valid: false with HTTP 200; only unparseable input yields 400.
Somente leituraEscopo api · 1 unidade de cota por chamada com chavePOST/v1/verify
convert_signatureConvert a signature between DER and raw r‖sDecodes a signature (DER or raw, auto-detected; hex/base64/base64url) and returns both encodings plus r, s and the high-S flag. normalize: "low-s" replaces a high-S s with n − s. Warnings list DER canonicality deviations (BER lengths, missing 0x00 pads, trailing bytes) and curve-ambiguity notes.
Somente leituraEscopo api · 1 unidade de cota por chamada com chavePOST/v1/convert
decode_jwtDecode a JWT (no signature check)Decodes a compact JWS token: header, payload, enriched exp/iat/nbf time claims and a classification of the algorithm. The signature is NOT verified — the response carries verified: false explicitly. Use /v1/jwt/verify to check ES* signatures.
Somente leituraEscopo api · 1 unidade de cota por chamada com chavePOST/v1/jwt/decode
verify_jwtVerify an ES256/ES384/ES512 JWT signatureVerifies the token's ECDSA signature against a public key (PEM SPKI, EC JWK, or bare SEC1 point). Non-ECDSA algorithms (HS*, RS*, PS*, EdDSA, ES256K, none) return 400 with code unsupported_algorithm. A signature that fails verification returns valid: false with HTTP 200. Time claims are noted in explanations but do not affect valid.
Somente leituraEscopo api · 1 unidade de cota por chamada com chavePOST/v1/jwt/verify
decode_certificateDecode an X.509 certificate or chainAccepts PEM (one or more CERTIFICATE blocks — a whole chain works) or a single DER certificate as base64/hex. Returns a structured summary per certificate — subject, issuer, validity, key and signature algorithms, SAN, key usage, fingerprint — plus assessments (weak hashes, expiry, CA/Browser Forum lifetime limits, post-quantum notes).
Somente leituraEscopo api · 1 unidade de cota por chamada com chavePOST/v1/cert/decode
get_domain_healthTLS signature-health grade for a domainConnects to the domain on port 443, examines the served certificate chain, key and signature algorithms, protocol versions and lifetimes, and returns a letter grade with findings, plus the leaf certificate's expiry and key algorithm as structured fields. Results are cached for 1 hour. Only public DNS hostnames are accepted — IP addresses, single-label names and private/reserved addresses are refused. Extra rate limit: 10 requests/minute per IP. A fresh scan can take several seconds.
Somente leitura, conecta-se ao host que você indicarEscopo scan · 5 unidades de cota por chamada com chaveGET/v1/health/{domain}
explain_errorExplain an error messageLooks up an error message from a cryptography, TLS, certificate, JWT, SSH, code-signing or Web3 library in the ecdsa.com error catalog (299 messages, reproduced against the libraries that print them) and returns what it means, its likely causes and step-by-step fixes with code. Paste the message as printed; a whole log excerpt or stack trace works too. Never include private keys or secrets: input containing a private key is refused.
Somente leituraEscopo api · 1 unidade de cota por chamada com chave
lookup_oidLook up an object identifier (OID)Resolves an ASN.1 object identifier used in X.509 certificates, CSRs, CMS/PKCS#7, PKCS#8/#12 and post-quantum PKI against the ecdsa.com OID catalog (938 identifiers: curated, IANA SMI arcs, CCADB EV policies). Accepts a dotted OID, its DER encoding in hex, or a name such as prime256v1 or ecdsa-with-SHA256; returns the name, aliases, category, DER encoding, OpenSSL names and references. Unknown OIDs still get their DER encoding and nearest known ancestor.
Somente leituraEscopo api · 1 unidade de cota por chamada com chave
lookup_algorithmLook up a cryptographic algorithm identifierResolves an algorithm identifier against the IANA registries for JOSE and COSE (algorithms, key types, curves), TLS (cipher suites, signature schemes, supported groups), SSH, DNSSEC and HPKE: what it is, its code point, recommendation status, parameters (curve, hash, key size), names in OpenSSL/GnuTLS/NSS and the defining RFCs. Accepts names (ES256, TLS_AES_128_GCM_SHA256, ECDHE-ECDSA-AES128-GCM-SHA256, ecdsa-sha2-nistp256, X25519MLKEM768) or code points (-7, 0x0403, 13); `registry` narrows the search.
Somente leituraEscopo api · 1 unidade de cota por chamada com chave
lookup_curveLook up an elliptic curveDescribes a named elliptic curve from the ecdsa.com curve catalog (54 curves, each checked arithmetically): its names in every standard (SEC 2, NIST, ANSI X9.62, JOSE/COSE, SSH, TLS), OIDs with DER encoding, domain parameters, security level, status (recommended to broken) and where it is used. Accepts any spelling — P-256, secp256r1, prime256v1, nistp256, X25519, Ed25519, brainpoolP256r1 — or the curve's OID.
Somente leituraEscopo api · 1 unidade de cota por chamada com chave
glossaryDefine a cryptography termDefines a term from the ecdsa.com glossary (302 terms on signatures, JOSE, PKI, TLS, email authentication, Web3, post-quantum cryptography, identity and supply chain): a one-sentence definition, the explanation from the term's page, references to the standards and related terms, tools and errors.
Somente leituraEscopo api · 1 unidade de cota por chamada com chave
Limites
As chamadas anônimas compartilham a cota da API REST: 60 requisições por minuto por IP, mais 10 por minuto para get_domain_health, cujas varreduras reais também consomem as cotas de varredura compartilhadas. Clientes hospedados — os conectores do claude.ai e do Claude Desktop — fazem as chamadas a partir da nuvem da Anthropic, então os usuários deles contam para a mesma cota por IP, e o uso intenso recebe rate_limited.
Chaves privadas
Argumentos que contêm material de chave privada — um bloco PEM PRIVATE KEY, uma chave OpenSSH, SSH2 ou PuTTY, uma JWK com “d” — são recusados com private_key_rejected antes de qualquer outra coisa acontecer, exatamente como na API REST. Os argumentos nunca são registrados em log.