How to add eSignatures.com MCP Server to Windsurf

AI-friendly electronic signatures: create, edit, send, and manage Markdown-based contracts via the eSignatures.com API. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 37★ · stdio · apikey

Windsurf config for eSignatures.com MCP Server

{
  "mcpServers": {
    "esignatures-com-mcp-server": {
      "command": "uvx",
      "args": [
        "mcp-server-esignatures"
      ],
      "env": {
        "ESIGNATURES_SECRET_TOKEN": "your-esignatures-api-secret-token"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the eSignatures.com MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5eSignatures.com MCP Server's tools become available to Cascade.

Before you start

An eSignatures.com account and API secret token (free accounts can test templates and send test contracts)
uv / uvx (Python) to run the published server, or a local clone of the repository for development
An MCP-compatible client such as Claude Desktop

What eSignatures.com MCP Server can do in Windsurf

create_contract

Draft for review or send a contract.

query_contract

Retrieve contract info.

withdraw_contract

Withdraw an active contract.

delete_contract

Delete a draft or test contract.

list_recent_contracts

List the recent contracts.

add_contract_signer

Add a signer to an existing contract.

update_contract_signer

Update an existing signer's contact details.

resend_contract_signer_request

Send or resend the sign request to a signer.

Security

Requires an eSignatures.com API secret token, provided via the ESIGNATURES_SECRET_TOKEN environment variable. The server can create, send, withdraw, and delete legally binding contracts and manage signers, so guard the token and review agent actions accordingly.

eSignatures.com MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the eSignatures.com MCP Server config there under the "mcpServers" key and restart the client.

Is eSignatures.com MCP Server safe to use with Windsurf?

How do I authenticate?

Set the ESIGNATURES_SECRET_TOKEN environment variable to your eSignatures.com API secret token. Create a free account at https://esignatures.com to obtain one and test the integration.

How do I install it in Claude Desktop?

Add an mcpServers entry to claude_desktop_config.json. The published configuration uses command "uvx" with args ["mcp-server-esignatures"] and the ESIGNATURES_SECRET_TOKEN env var. A development configuration using "uv --directory <path> run mcp-server-esignatures" is also documented for running from a local clone.

Can contracts be edited after they're sent?

Yes. eSignatures.com contracts are Markdown-based and remain fully editable throughout their lifecycle, so agents can amend wording and placeholder fields even on active contracts.

View repo Full eSignatures.com MCP Server page