# mcp-server

Connects AI tools to the SignDocs Brasil API to prepare signature envelopes, issue signing links, and verify ICP-Brasil digital stamps.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: signdocsbrasil
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/signdocsbrasil/signdocs-mcp-server
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/mcp/signdocsbrasil-mcp-server

## What it does

This server connects AI assistants to the SignDocs Brasil e-signature platform. It provides actions to initiate single-signer sessions, manage multi-party envelopes, resend verification OTP codes, and download stamped PDF files. Built-in tools can also inspect cryptographic evidence and validate existing PDF signatures.

Under the hood, the server wraps the official `@signdocs-brasil/api` SDK, delegating OAuth2 token handling, caching, and retry logic to the client library. It supports both local `stdio` execution and remote streaming HTTP endpoints on hosted infrastructure.

Running tests in `hml` prevents accidental consumption of your account quota, because test data expires in roughly 7 days while `production` generates legally binding signatures.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.signdocs.com.br/mcp`
- Environment variables: `SIGNDOCS_CLIENT_ID`, `SIGNDOCS_CLIENT_SECRET`, `SIGNDOCS_ENVIRONMENT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.signdocs.com.br/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SIGNDOCS_CLIENT_ID=<SIGNDOCS_CLIENT_ID> --env SIGNDOCS_CLIENT_SECRET=<SIGNDOCS_CLIENT_SECRET> --env SIGNDOCS_ENVIRONMENT=<SIGNDOCS_ENVIRONMENT> --transport stdio signdocsbrasil-mcp-server -- npx -y @signdocs-brasil/mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add signdocsbrasil-mcp-server --url https://mcp.signdocs.com.br/mcp
```

2. **Platform CLI**
```bash
codex mcp add signdocsbrasil-mcp-server --env SIGNDOCS_CLIENT_ID=<SIGNDOCS_CLIENT_ID> --env SIGNDOCS_CLIENT_SECRET=<SIGNDOCS_CLIENT_SECRET> --env SIGNDOCS_ENVIRONMENT=<SIGNDOCS_ENVIRONMENT> -- npx -y @signdocs-brasil/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "signdocsbrasil-mcp-server": {
            "url": "https://mcp.signdocs.com.br/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "signdocsbrasil-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@signdocs-brasil/mcp-server"
            ],
            "env": {
                "SIGNDOCS_CLIENT_ID": "<SIGNDOCS_CLIENT_ID>",
                "SIGNDOCS_CLIENT_SECRET": "<SIGNDOCS_CLIENT_SECRET>",
                "SIGNDOCS_ENVIRONMENT": "<SIGNDOCS_ENVIRONMENT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "signdocsbrasil-mcp-server": {
            "type": "http",
            "url": "https://mcp.signdocs.com.br/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "signdocsbrasil-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@signdocs-brasil/mcp-server"
            ],
            "env": {
                "SIGNDOCS_CLIENT_ID": "<SIGNDOCS_CLIENT_ID>",
                "SIGNDOCS_CLIENT_SECRET": "<SIGNDOCS_CLIENT_SECRET>",
                "SIGNDOCS_ENVIRONMENT": "<SIGNDOCS_ENVIRONMENT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http signdocsbrasil-mcp-server https://mcp.signdocs.com.br/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SIGNDOCS_CLIENT_ID=<SIGNDOCS_CLIENT_ID> -e SIGNDOCS_CLIENT_SECRET=<SIGNDOCS_CLIENT_SECRET> -e SIGNDOCS_ENVIRONMENT=<SIGNDOCS_ENVIRONMENT> signdocsbrasil-mcp-server npx -y @signdocs-brasil/mcp-server
```
Replace <…> with your own values

## When to use it
- Generate signing URLs for single-party contracts
- Set up multi-signer document envelopes
- Validate ICP-Brasil digital signatures inside a PDF
- Register webhooks to track envelope status updates

## Example prompts
- Create a signing session for the agreement and return the signingUrl
- Add another signer to envelope session
- Check cryptographic signatures in the uploaded document

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4268
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2795
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1248
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1085
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1054
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 779

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43902
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 105

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md