{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2025-06-18",
  "serverInfo": {
    "name": "signeur",
    "title": "Signeur – electronic signatures",
    "version": "1.0.0"
  },
  "description": "Send PDFs for eIDAS-compliant electronic signature, track signature requests and manage webhooks through Signeur's REST API. Same API key as the REST API (Authorization: Bearer sgn_live_…).",
  "documentationUrl": "https://signeur.eu/docs",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://api.signeur.eu/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "resources": {
      "listChanged": false
    },
    "prompts": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": true,
    "schemes": [
      {
        "type": "http",
        "scheme": "bearer",
        "description": "Signeur API key from the dashboard."
      }
    ]
  },
  "tools": [
    {
      "name": "list_signature_requests",
      "title": "List signature requests",
      "description": "List the API key owner's signature requests, newest first, with cursor pagination. Filter by status (pending, sent, opened, partially_signed, signed, cancelled, declined, expired) and creation time. Use next_cursor from the result to fetch the next page.",
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "get_signature_request",
      "title": "Get a signature request",
      "description": "Status, signers (each with status and signed_at), timestamps, document hash and PDF retention of one signature request by id.",
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "list_signers",
      "title": "List signers",
      "description": "Every signer of a signature request with their individual status, IP and geo details.",
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "get_document_links",
      "title": "Get download links",
      "description": "Links to the sealed PDF and the audit-trail PDF of a signed request. The links are REST API URLs that must be fetched with the same Authorization: Bearer API key. Returns the current status if the request is not signed yet.",
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "create_upload_url",
      "title": "Create an upload URL",
      "description": "Reserve an upload slot for a PDF and get a pre-signed URL. PUT the PDF bytes there with Content-Type: application/pdf (max 10 MB, 24 h), then pass the returned upload_id as document.upload_id to prepare_signature_request / create_signature_request. Use this for files larger than about 3 MB; smaller files can be sent inline as content_base64.",
      "annotations": {
        "readOnlyHint": false,
        "idempotentHint": false
      }
    },
    {
      "name": "prepare_signature_request",
      "title": "Preview a signature request",
      "description": "Validate a signature request without sending it: checks the signers, the PDF (if given inline) and returns the total price. Nothing is created or billed. Call this first, show the summary to the user, and only then call create_signature_request with confirm=true.",
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "create_signature_request",
      "title": "Send for signature",
      "description": "Create a signature request and email the invitations. BILLABLE: 0.89 EUR incl. VAT per signer, charged to the API key owner's subscription. Requires confirm=true, which must only be set after the user has approved the summary from prepare_signature_request. The call is idempotent for identical arguments within 24 hours.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "cancel_signature_request",
      "title": "Cancel a signature request",
      "description": "Cancel a pending request so the signing links stop working. Cannot be undone; a signed request cannot be cancelled.",
      "annotations": {
        "destructiveHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "resend_invitation",
      "title": "Resend an invitation",
      "description": "Send the invitation email again to one signer who has not signed yet.",
      "annotations": {
        "readOnlyHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "list_webhook_endpoints",
      "title": "List webhook endpoints",
      "description": "Configured webhook endpoints (URL, status, subscribed event types). Secrets are never returned.",
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "create_webhook_endpoint",
      "title": "Create a webhook endpoint",
      "description": "Register an HTTPS URL to receive signature_request.* and signer.signed events. The HMAC secret is returned once in this response; store it to verify X-Signeur-Signature.",
      "annotations": {
        "readOnlyHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "rotate_webhook_secret",
      "title": "Rotate a webhook secret",
      "description": "Replace the HMAC secret of a webhook endpoint. The old secret stops working immediately; the new one is returned once.",
      "annotations": {
        "destructiveHint": true
      }
    }
  ]
}