# Signbee — Full Technical Documentation & LLM Specification
> Document e-signing infrastructure built specifically for autonomous AI agents, developers, and headless automation.

## System Overview
Signbee provides single-endpoint document generation, two-party cryptographic signing, and tamper-evident certificate sealing without SDK dependencies or mandatory account creation.

- **Production URL**: https://signb.ee
- **API Spec**: https://signb.ee/openapi.json
- **Short LLMs Reference**: https://signb.ee/llms.txt
- **MCP Server**: `npx -y signbee-mcp` (npm)
- **Agent Skill**: `npx skills add signbee/skill --skill signbee -g`

---

## 1. Authentication & Security Model
- **Optional Bearer Auth**: Include `Authorization: Bearer <api_key>` in HTTP headers.
- **Anonymous Mode**: When no API key is provided, the sender's identity is verified out-of-band via a 6-digit email OTP challenge before the signing ceremony link reaches the recipient.
- **Audit Trails**: Every completed agreement appends a cryptographic Certificate of Completion with SHA-256 document hashing, exact signing timestamps (UTC), IP telemetry, and user-agent fingerprints.
- **Legal Enforceability**: Fully compliant with US ESIGN Act (15 U.S.C. § 7001), Uniform Electronic Transactions Act (UETA § 7), EU eIDAS (Regulation No 910/2014 - SES/AES), and UK Electronic Communications Act 2000.

---

## 2. API Endpoints Reference

### `POST /api/v1/send` — Dispatch Document for E-Signing
Creates a contract from Markdown or an existing PDF and initiates the two-party signing workflow.

#### Headers
```http
POST /api/v1/send HTTP/1.1
Host: signb.ee
Content-Type: application/json
Authorization: Bearer <api_key>  # Optional
```

#### Request Body Parameters
| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `recipient_name` | string | Yes | Full legal name of the recipient signer |
| `recipient_email` | string | Yes | Valid email address of the recipient |
| `markdown` | string | Conditional | Contract text in markdown format (min 10 chars, max 50KB). Required if `pdf_url` omitted. |
| `pdf_url` | string | Conditional | Public HTTPS URL to an existing PDF. Required if `markdown` omitted. |
| `sender_name` | string | Conditional | Full name of the sender (required if unauthenticated). |
| `sender_email` | string | Conditional | Email address of the sender (required if unauthenticated). |
| `title` | string | No | Document title. Defaults to the first markdown heading (`#`). |
| `expires_in_days` | integer | No | Expiration window in days (default: 7). |

#### Example Request (Authenticated Agent Dispatch)
```json
{
  "title": "Master Services Agreement",
  "markdown": "# Master Services Agreement\n\nThis Agreement is entered into between **Alpha Corp** and **Beta LLC**.\n\n## 1. Scope of Work\nBeta LLC shall deliver autonomous agent orchestration services as specified in Exhibit A.\n\n## 2. Term & Termination\nThis Agreement shall remain in effect for a period of 12 months.",
  "recipient_name": "Sarah Connor",
  "recipient_email": "sarah@cyberdyne.com"
}
```

#### Example Response (HTTP 200 OK)
```json
{
  "document_id": "cmm_9f83a71b28d4e9",
  "status": "pending_recipient",
  "sender": "Alice Chen",
  "recipient": "Sarah Connor",
  "expires_at": "2026-09-05T12:00:00.000Z"
}
```

---

### `GET /api/v1/documents/{id}` — Retrieve Document Status
Fetches real-time status, signing metadata, and PDF URLs for a document. Requires `Authorization: Bearer <api_key>`.

#### Example Response (HTTP 200 OK)
```json
{
  "document_id": "cmm_9f83a71b28d4e9",
  "status": "completed",
  "title": "Master Services Agreement",
  "sender": {
    "name": "Alice Chen",
    "email": "alice@alphacorp.com",
    "signed_at": "2026-08-29T18:00:00.000Z"
  },
  "recipient": {
    "name": "Sarah Connor",
    "email": "sarah@cyberdyne.com",
    "signed_at": "2026-08-29T18:15:30.000Z"
  },
  "original_pdf_url": "https://signb.ee/uploads/original_9f83a7.pdf",
  "signed_pdf_url": "https://signb.ee/uploads/signed_9f83a7.pdf",
  "signing_url": "https://signb.ee/sign/tok_7f93ba8291",
  "sha256_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "created_at": "2026-08-29T17:55:00.000Z"
}
```

---

## 3. Model Context Protocol (MCP) Tool Specifications

To integrate Signbee with Claude Desktop, Cursor, or autonomous LLM tool calling:

```json
{
  "mcpServers": {
    "signbee": {
      "command": "npx",
      "args": ["-y", "signbee-mcp"],
      "env": {
        "SIGNBEE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

### Tools Exposed by `signbee-mcp`:
1. **`send_document`**:
   - `document` (string, required): Markdown formatted agreement text.
   - `recipient_name` (string, required): Recipient's full name.
   - `recipient_email` (string, required): Recipient's email address.
   - `title` (string, optional): Title of the agreement.
2. **`send_document_pdf`**:
   - `pdf_url` (string, required): Public HTTPS link to existing PDF.
   - `recipient_name` (string, required): Recipient's full name.
   - `recipient_email` (string, required): Recipient's email address.

---

## 4. Multi-Language SDK Code Examples

### TypeScript / Node.js
```ts
import axios from "axios";

async function sendContract() {
  const response = await axios.post(
    "https://signb.ee/api/v1/send",
    {
      title: "Consulting Agreement",
      markdown: "# Consulting Agreement\n\nParties agree to terms...",
      recipient_name: "Jane Doe",
      recipient_email: "jane@client.com",
    },
    {
      headers: {
        Authorization: `Bearer ${process.env.SIGNBEE_API_KEY}`,
        "Content-Type": "application/json",
      },
    }
  );
  console.log("Document Dispatched:", response.data.document_id);
}
```

### Python (Requests / httpx)
```python
import requests
import os

def send_contract():
    url = "https://signb.ee/api/v1/send"
    headers = {
        "Authorization": f"Bearer {os.getenv('SIGNBEE_API_KEY')}",
        "Content-Type": "application/json"
    }
    payload = {
        "title": "Mutual Non-Disclosure Agreement",
        "markdown": "# Mutual NDA

Confidentiality terms...",
        "recipient_name": "Alex Mercer",
        "recipient_email": "alex@enterprise.com"
    }
    res = requests.post(url, json=payload, headers=headers)
    print("Contract Status:", res.json())
```

---

## 5. Pricing Tiers & Quotas
- **Free**: $0/mo — 5 documents/mo, SHA-256 certificate, standard email delivery, zero credit card required.
- **Pro**: $9/mo — 100 documents/mo, instant sending, API key dashboard, unlimited templates.
- **Business**: $19/mo — Unlimited documents, custom branding, priority support, webhooks.