[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77TCTP9RFWXZKF91SE13RAE":3,"skill-same:01M77TCTP9RFWXZKF91SE13RAE":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M77TCTP9RFWXZKF91SE13RAE","saysigned",null,"Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fs\u002Fsaysigned\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# SaySigned — AI Agent E-Signature Skill\n\n> **E-signatures for AI agents.** Legally binding under ESIGN Act & UETA Section 14.\n> Two delivery modes: **API** (agent-to-agent) and **Email** (agent-to-human). Register, sign contracts, verify — all via REST or consent UI.\n\n**Publisher:** SaySigned, Inc.\n**Homepage:** [https:\u002F\u002Fwww.saysigned.com](https:\u002F\u002Fwww.saysigned.com)\n**Documentation:** [https:\u002F\u002Fwww.saysigned.com\u002Fdocs](https:\u002F\u002Fwww.saysigned.com\u002Fdocs)\n**Base URL:** `https:\u002F\u002Fapi.saysigned.com`\n**MCP Endpoint:** `https:\u002F\u002Fmcp.saysigned.com`\n**TLS Required:** All endpoints enforce HTTPS. Verify certificates for `*.saysigned.com` before connecting.\n\n**Authentication:** Pass your API key in the `X-API-Key` header. Keys start with `ss_live_`. Public endpoints (register, verify, templates) don't require authentication.\n\n## MCP Server (Recommended for AI Agents)\n\nConnect directly to the remote MCP endpoint — no local install, no HTTP requests to craft.\n\n> **Auth note:** MCP clients send `Authorization: Bearer \u003Capi_key>`. The MCP server extracts your key and forwards it as `X-API-Key` internally. For direct REST calls, use the `X-API-Key` header.\n\n### Setup\n\n> **Human approval required.** Steps 1, 4, and 5 modify your MCP client configuration. Always show the user what you're about to change and ask for their confirmation before writing to config files or restarting the MCP client. Never modify config silently.\n\n**Step 1.** Show the user the following MCP config and ask for confirmation before adding it:\n\n```json\n{\n  \"mcpServers\": {\n    \"saysigned\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https:\u002F\u002Fmcp.saysigned.com\"\n    }\n  }\n}\n```\n\nAfter the user confirms, add it to the MCP config. No API key is needed yet — public tools work immediately.\n\n**Step 2.** Restart your MCP client so it loads the new server.\n\n**Step 3.** Call the `saysigned_register` tool (no auth required) with the agent's `name` and `email`. The response contains an `api_key` — **save it immediately, it is shown once and cannot be retrieved later.** Keys start with `ss_live_`.\n\n**Step 4.** Show the user the updated config with the auth header and ask for confirmation before writing it:\n\n```json\n{\n  \"mcpServers\": {\n    \"saysigned\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https:\u002F\u002Fmcp.saysigned.com\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ss_live_PASTE_YOUR_ACTUAL_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n**Step 5.** After the user confirms, restart your MCP client so it picks up the auth header. All authenticated tools now work.\n\n> **Human-in-the-loop for config changes.** The user must confirm before you (1) add or modify MCP config entries, (2) store API keys in config files, or (3) restart the MCP client. You may handle registration, envelope creation, signing, and verification autonomously — those are normal API operations that don't modify the agent's configuration.\n\n### Already have a key?\n\nIf you already have an API key (starts with `ss_live_`), skip to Step 4 — show the user the config with `headers`, get their confirmation, and restart.\n\n### MCP Workflow (signing flow)\n\n1. **Prepare the contract** — two options:\n   - **Use a template:** call `saysigned_list_templates` → `saysigned_get_template` to discover required variables, then pass `template_id` + `variables` in the contract field.\n   - **Bring your own text:** pass your own contract content in the `clauses` array. Each clause has `id`, `title`, and `body`. You can put an entire document into a single clause or split it into sections. **Use this when you have your own NDA, agreement, or any custom document.**\n2. **Create envelope** — `saysigned_create_envelope` with `title`, `contract`, and `recipients` array.\n3. **Send envelope** — `saysigned_send_envelope` with the envelope_id. Response includes each recipient's `id` and `access_token`. **Save these — they are needed for signing.**\n4. **Sign** — For API recipients: `saysigned_sign` for each recipient, passing their `envelope_id`, `recipient_id`, `access_token`, and `signature_data` (at minimum `full_name`). For email recipients: the human reviews and gives consent at `doc.saysigned.com` — no action needed from the agent.\n5. **Verify** — `saysigned_verify` with the envelope_id. No auth needed.\n\n### Critical Notes for AI Agents\n\n- **You don't have to use a template.** If you have your own contract text (an NDA, agreement, policy — any document), pass it directly via `clauses`. Templates are a convenience, not a requirement.\n- **Always call `saysigned_get_template` before creating an envelope with a template.** The required variables differ per template and the API will reject unknown or missing variables.\n- **`saysigned_send_envelope` returns access tokens.** You must capture and use these tokens for signing. They are 128-character hex strings.\n- **Signing does not use your API key.** The `saysigned_sign` and `saysigned_decline` tools authenticate via the `access_token` parameter, not the API key header.\n- **The envelope auto-completes** when the last recipient signs. You don't need to call a separate \"complete\" endpoint.\n- **Auth header is forwarded automatically.** Authenticated tools (`create_envelope`, `send_envelope`, `get_envelope`, `get_profile`, etc.) use the API key from your MCP client's `Authorization` header. Public tools (`register`, `verify`, `list_templates`, `get_template`) work without it.\n- **`delivery_method: \"email\"` sends a signing link to a real human.** The human reviews the contract at `doc.saysigned.com` and gives consent via browser. Email recipients do NOT get an `access_token` in the send response — they authenticate via a URL token in their email link. Use `delivery_method: \"api\"` (default) for agent-to-agent signing.\n- **Poll or use webhooks for email recipients.** Since humans sign asynchronously, use `saysigned_get_envelope` to poll for status changes or configure a `webhook_url` to receive `recipient.viewed` and `recipient.signed` events.\n\n### All 14 MCP Tools\n\n| Tool | Auth | Description |\n|------|------|-------------|\n| `saysigned_register` | None | Register agent, get API key |\n| `saysigned_create_envelope` | API key | Create draft envelope |\n| `saysigned_send_envelope` | API key | Send for signing, get access tokens |\n| `saysigned_get_envelope` | API key | Get envelope details + status |\n| `saysigned_void_envelope` | API key | Cancel a sent (not completed) envelope |\n| `saysigned_sign` | Access token | Sign as a recipient |\n| `saysigned_decline` | Access token | Decline to sign |\n| `saysigned_verify` | None | Verify cryptographic integrity |\n| `saysigned_get_audit_trail` | API key | Get hash-chain audit trail |\n| `saysigned_list_templates` | None | List available contract templates |\n| `saysigned_get_template` | None | Get template details + required variables |\n| `saysigned_billing_setup` | API key | Upgrade to paid plan |\n| `saysigned_get_usage` | API key | Current billing period usage |\n| `saysigned_get_profile` | API key | Agent profile + plan info |\n\n---\n\n## Complete End-to-End Example\n\nThis is a full working flow: register, create an NDA, send it, both parties sign, then verify. Every response shown is from the real production API.\n\n### Step 1 — Register (no auth needed)\n\n```bash\ncurl -s -X POST https:\u002F\u002Fapi.saysigned.com\u002Fagents\u002Fregister \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\": \"My AI Agent\", \"email\": \"agent@example.com\"}'\n```\n\n```json\n{\n  \"agent_id\": \"7773b4af-44d1-44fc-8db7-05d9bc95b541\",\n  \"api_key\": \"ss_live_203bff0e53ba167462aa2cdcbd8e189e2909d37cf76c31da675cb1dba7dc0026\",\n  \"plan\": \"free\",\n  \"free_envelopes_remaining\": 5\n}\n```\n\n**Save the `api_key` — it is shown once and cannot be retrieved later.**\n\n### Step 2 — Create an envelope\n\nUse the `api_key` from step 1 in the `X-API-Key` header. Use `template_id` for standard contracts or provide custom `clauses`.\n\n```bash\ncurl -s -X POST https:\u002F\u002Fapi.saysigned.com\u002Fenvelopes \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-Key: ss_live_203bff0e53ba167462aa2cdcbd8e189e2909d37cf76c31da675cb1dba7dc0026\" \\\n  -d '{\n    \"title\": \"Mutual NDA — Acme & Beta\",\n    \"contract\": {\n      \"template_id\": \"nda_mutual_v1\",\n      \"variables\": {\n        \"disclosing_party_name\": \"Acme Corp\",\n        \"receiving_party_name\": \"Beta Inc\",\n        \"effective_date\": \"2026-02-09\",\n        \"purpose\": \"Evaluating a potential partnership\",\n        \"governing_law_state\": \"California\"\n      }\n    },\n    \"recipients\": [\n      {\"name\": \"Alice\", \"email\": \"alice@acme.com\", \"role\": \"signer\"},\n      {\"name\": \"Bob\", \"email\": \"bob@beta.com\", \"role\": \"signer\"}\n    ]\n  }'\n```\n\n```json\n{\n  \"id\": \"2c272d15-cd4b-4c0d-96c0-bd7438b66699\",\n  \"status\": \"draft\",\n  \"title\": \"Mutual NDA — Acme & Beta\",\n  \"recipients\": [\n    {\"id\": \"62f73ba5-05a0-4223-8f55-e880047a7b3e\", \"name\": \"Alice\", \"status\": \"pending\"},\n    {\"id\": \"cc0aeb32-eb9d-420d-ab93-1d42400f85b9\", \"name\": \"Bob\", \"status\": \"pending\"}\n  ]\n}\n```\n\n**Save the envelope `id` and each recipient's `id`.**\n\n### Step 3 — Send the envelope\n\nThis consumes 1 envelope from your quota (free tier) or reports 1 metered event (paid plan). Recipients get `access_token` values — these are how they authenticate when signing.\n\n```bash\ncurl -s -X POST https:\u002F\u002Fapi.saysigned.com\u002Fenvelopes\u002F2c272d15-cd4b-4c0d-96c0-bd7438b66699\u002Fsend \\\n  -H \"X-API-Key: ss_live_203bff0e53ba167462aa2cdcbd8e189e2909d37cf76c31da675cb1dba7dc0026\"\n```\n\n```json\n{\n  \"id\": \"2c272d15-cd4b-4c0d-96c0-bd7438b66699\",\n  \"status\": \"sent\",\n  \"recipients\": [\n    {\"id\": \"62f73ba5-05a0-4223-8f55-e880047a7b3e\", \"name\": \"Alice\", \"status\": \"sent\", \"access_token\": \"600b9b4297b2921396a1db138a80801c7dfb5101...\"},\n    {\"id\": \"cc0aeb32-eb9d-420d-ab93-1d42400f85b9\", \"name\": \"Bob\", \"status\": \"sent\", \"access_token\": \"952340a770b96740e2696c306ad490b28556952e...\"}\n  ]\n}\n```\n\n**Save each recipient's `access_token`. Distribute tokens to the respective signers.**\n\n### Step 4 — Recipients sign\n\nEach recipient signs using their `access_token` via the `X-Access-Token` header (recommended) or `?access_token=` query parameter. No API key needed — the token is the auth.\n\n```bash\n# Alice signs\ncurl -s -X POST \"https:\u002F\u002Fapi.saysigned.com\u002Fenvelopes\u002F2c272d15-cd4b-4c0d-96c0-bd7438b66699\u002Frecipients\u002F62f73ba5-05a0-4223-8f55-e880047a7b3e\u002Fsign\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-Access-Token: 600b9b4297b2921396a1db138a80801c7dfb5101...\" \\\n  -d '{\"signature_data\": {\"full_name\": \"Alice Chen\", \"title\": \"CEO\"}}'\n```\n\n```json\n{\n  \"signed\": true,\n  \"recipient_id\": \"62f73ba5-05a0-4223-8f55-e880047a7b3e\",\n  \"envelope_id\": \"2c272d15-cd4b-4c0d-96c0-bd7438b66699\",\n  \"signed_at\": \"2026-02-09T04:09:24.111Z\"\n}\n```\n\n```bash\n# Bob signs (last signer → envelope automatically completes with RFC 3161 timestamp)\ncurl -s -X POST \"https:\u002F\u002Fapi.saysigned.com\u002Fenvelopes\u002F2c272d15-cd4b-4c0d-96c0-bd7438b66699\u002Frecipients\u002Fcc0aeb32-eb9d-420d-ab93-1d42400f85b9\u002Fsign\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-Access-Token: 952340a770b96740e2696c306ad490b28556952e...\" \\\n  -d '{\"signature_data\": {\"full_name\": \"Bob Smith\", \"title\": \"CTO\"}}'\n```\n\n```json\n{\n  \"signed\": true,\n  \"recipient_id\": \"cc0aeb32-eb9d-420d-ab93-1d42400f85b9\",\n  \"envelope_id\": \"2c272d15-cd4b-4c0d-96c0-bd7438b66699\",\n  \"signed_at\": \"2026-02-09T04:09:25.190Z\"\n}\n```\n\n### Step 5 — Verify (public, no auth needed)\n\n```bash\ncurl -s -X POST https:\u002F\u002Fapi.saysigned.com\u002Fverify \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"envelope_id\": \"2c272d15-cd4b-4c0d-96c0-bd7438b66699\"}'\n```\n\n```json\n{\n  \"envelope_id\": \"2c272d15-cd4b-4c0d-96c0-bd7438b66699\",\n  \"status\": \"completed\",\n  \"chain_verification\": {\"valid\": true, \"entries_checked\": 5},\n  \"timestamp_verification\": {\n    \"valid\": true,\n    \"gen_time\": \"2026-02-09T04:09:25+00:00\",\n    \"tsa_name\": \"DigiCert SHA256 RSA4096 Timestamp Responder 2025 1\"\n  },\n  \"recipients\": [\n    {\"name\": \"Alice\", \"email\": \"alice@acme.com\", \"role\": \"signer\", \"status\": \"signed\", \"signed_at\": \"2026-02-09T04:09:24.111Z\"},\n    {\"name\": \"Bob\", \"email\": \"bob@beta.com\", \"role\": \"signer\", \"status\": \"signed\", \"signed_at\": \"2026-02-09T04:09:25.190Z\"}\n  ],\n  \"completed_at\": \"2026-02-09T04:09:25.039Z\"\n}\n```\n\n---\n\n## Bring Your Own Contract\n\nYou don't need a template. If you have your own document text — an NDA your user provided, a custom agreement, any markdown or plain text — pass it directly via `clauses`. Each clause needs an `id`, `title`, and `body`.\n\n**Single-clause approach** (simplest — put the entire document in one clause):\n\n```bash\ncurl -s -X POST https:\u002F\u002Fapi.saysigned.com\u002Fenvelopes \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-Key: YOUR_API_KEY\" \\\n  -d '{\n    \"title\": \"NDA — Acme & Beta\",\n    \"contract\": {\n      \"clauses\": [\n        {\n          \"id\": \"nda\",\n          \"title\": \"Mutual Non-Disclosure Agreement\",\n          \"body\": \"This Mutual Non-Disclosure Agreement is entered into by Acme Corp (\\\"Party A\\\") and Beta Inc (\\\"Party B\\\")...\\n\\n1. Definition of Confidential Information...\\n\\n2. Obligations of Receiving Party...\\n\\n3. Term. This Agreement shall remain in effect for two (2) years...\"\n        }\n      ]\n    },\n    \"recipients\": [\n      {\"name\": \"Alice\", \"email\": \"alice@acme.com\", \"role\": \"signer\"},\n      {\"name\": \"Bob\", \"email\": \"bob@beta.com\", \"role\": \"signer\"}\n    ]\n  }'\n```\n\n**Multi-clause approach** (split into sections for cleaner presentation):\n\n```bash\ncurl -s -X POST https:\u002F\u002Fapi.saysigned.com\u002Fenvelopes \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-Key: YOUR_API_KEY\" \\\n  -d '{\n    \"title\": \"NDA — Acme & Beta\",\n    \"contract\": {\n      \"clauses\": [\n        {\"id\": \"1\", \"title\": \"1. Definition of Confidential Information\", \"body\": \"\\\"Confidential Information\\\" means any non-public information disclosed by either party...\"},\n        {\"id\": \"2\", \"title\": \"2. Obligations of Receiving Party\", \"body\": \"The Receiving Party shall hold all Confidential Information in strict confidence...\"},\n        {\"id\": \"3\", \"title\": \"3. Term and Termination\", \"body\": \"This Agreement shall remain in effect for two (2) years from the Effective Date...\"},\n        {\"id\": \"4\", \"title\": \"4. Governing Law\", \"body\": \"This Agreement shall be governed by the laws of the State of California...\"}\n      ]\n    },\n    \"recipients\": [\n      {\"name\": \"Alice\", \"email\": \"alice@acme.com\", \"role\": \"signer\"},\n      {\"name\": \"Bob\", \"email\": \"bob@beta.com\", \"role\": \"signer\"}\n    ]\n  }'\n```\n\n**MCP equivalent** — same structure, just pass it to `saysigned_create_envelope`:\n\n```json\n{\n  \"title\": \"NDA — Acme & Beta\",\n  \"contract\": {\n    \"clauses\": [\n      {\"id\": \"nda\", \"title\": \"Mutual Non-Disclosure Agreement\", \"body\": \"Full text of the NDA here...\"}\n    ]\n  },\n  \"recipients\": [\n    {\"name\": \"Alice\", \"email\": \"alice@acme.com\", \"role\": \"signer\"},\n    {\"name\": \"Bob\", \"email\": \"bob@beta.com\", \"role\": \"signer\"}\n  ]\n}\n```\n\n> **When to use which:** Use **templates** when you want a standard contract and just need to fill in the blanks (party names, dates, etc.). Use **custom clauses** when you already have the contract text — from a file, a user-provided document, or your own drafting.\n\n---\n\n## Key Concepts\n\n- **IDs are UUIDs** — all envelope, recipient, and agent IDs are standard UUIDs (e.g., `2c272d15-cd4b-4c0d-96c0-bd7438b66699`)\n- **Access tokens are hex strings** — 128-character hex, passed via `X-Access-Token` header (recommended) or `?access_token=` query parameter\n- **API keys start with `ss_live_`** — REST: pass in `X-API-Key` header. MCP: pass as `Authorization: Bearer \u003Ckey>` (auto-translated)\n- **Templates** — use `GET \u002Ftemplates` to discover available templates and `GET \u002Ftemplates\u002F:id` to see required variables\n- **Signing order** — all recipients sign in parallel (no enforced order)\n- **Completion** — when the last signer signs, the envelope auto-completes with an RFC 3161 timestamp from DigiCert\n\nFree tier: **5 envelopes\u002Fmonth**, no credit card required. Upgrade: `POST \u002Fbilling\u002Fsetup` with `{\"plan\": \"payg\"}`.\n\n- **Delivery methods** — `\"api\"` (default) returns access tokens for programmatic signing; `\"email\"` sends an invitation email to a human who reviews and gives consent at `doc.saysigned.com`\n- **Email recipients** — human recipients authenticate via a URL token in their email link, not an access token. They review the contract in a browser and click \"Give Consent\" or \"Decline\"\n\n---\n\n## MCP Tool Definitions\n\nThese tool definitions are compatible with MCP (Model Context Protocol) runtimes. Each tool maps to a REST API endpoint.\n\n### saysigned_register\n\nCreate an agent account and get your API key.\n\n```json\n{\n  \"name\": \"saysigned_register\",\n  \"description\": \"Register a new AI agent account on SaySigned. Returns an API key (shown once — save it). Free tier: 5 envelopes\u002Fmonth.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"name\": { \"type\": \"string\", \"description\": \"Agent or organization name\" },\n      \"email\": { \"type\": \"string\", \"format\": \"email\", \"description\": \"Contact email (must be unique)\" },\n      \"company_name\": { \"type\": \"string\", \"description\": \"Company name (optional)\" },\n      \"webhook_url\": { \"type\": \"string\", \"format\": \"uri\", \"description\": \"URL to receive webhook notifications (optional)\" }\n    },\n    \"required\": [\"name\", \"email\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fagents\u002Fregister` — no auth required.\n\n---\n\n### saysigned_create_envelope\n\nCreate a draft envelope with a contract and recipients.\n\n```json\n{\n  \"name\": \"saysigned_create_envelope\",\n  \"description\": \"Create a draft envelope with contract content and recipients. Two ways to provide a contract: (1) Use template_id + variables for standard contracts (call saysigned_get_template first), or (2) provide your own contract text via the clauses array — each clause has an id, title, and body. You can put an entire document into a single clause or split it into sections. Use option 2 when you have your own NDA, agreement, or any custom document text. Set delivery_method: 'email' on a recipient to send them a consent link via email instead of returning an access token. Does not send — call saysigned_send_envelope to dispatch.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"title\": { \"type\": \"string\", \"description\": \"Envelope title\" },\n      \"description\": { \"type\": \"string\", \"description\": \"Brief description\" },\n      \"contract\": {\n        \"type\": \"object\",\n        \"description\": \"Contract content. Use template_id + variables for templates, or provide raw clauses.\",\n        \"properties\": {\n          \"template_id\": { \"type\": \"string\", \"description\": \"Template ID (e.g., 'nda_mutual_v1', 'service_agreement_v1')\" },\n          \"variables\": { \"type\": \"object\", \"description\": \"Template variables (see GET \u002Ftemplates\u002F:id for schema)\" },\n          \"clauses\": {\n            \"type\": \"array\",\n            \"description\": \"Custom clauses (when not using a template)\",\n            \"items\": {\n              \"type\": \"object\",\n              \"properties\": {\n                \"id\": { \"type\": \"string\" },\n                \"title\": { \"type\": \"string\" },\n                \"body\": { \"type\": \"string\" }\n              },\n              \"required\": [\"id\", \"title\", \"body\"]\n            }\n          },\n          \"signature_block\": {\n            \"type\": \"object\",\n            \"description\": \"Custom signature block (when not using a template)\"\n          }\n        }\n      },\n      \"recipients\": {\n        \"type\": \"array\",\n        \"items\": {\n          \"type\": \"object\",\n          \"properties\": {\n            \"name\": { \"type\": \"string\" },\n            \"email\": { \"type\": \"string\", \"format\": \"email\" },\n            \"role\": { \"type\": \"string\", \"enum\": [\"signer\", \"cc\", \"approver\", \"witness\"], \"default\": \"signer\" },\n            \"delivery_method\": { \"type\": \"string\", \"enum\": [\"api\", \"email\"], \"default\": \"api\", \"description\": \"'api' (default) for AI agent signing, 'email' to send a consent link to a human\" }\n          },\n          \"required\": [\"name\", \"email\"]\n        }\n      },\n      \"expires_at\": { \"type\": \"string\", \"format\": \"date-time\", \"description\": \"Expiration date (optional)\" },\n      \"metadata\": { \"type\": \"object\", \"description\": \"Custom key-value metadata (optional)\" }\n    },\n    \"required\": [\"title\", \"contract\", \"recipients\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fenvelopes` — requires `X-API-Key` header.\n\n**Example — Custom contract (no template):**\n```bash\ncurl -s -X POST https:\u002F\u002Fapi.saysigned.com\u002Fenvelopes \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-Key: YOUR_API_KEY\" \\\n  -d '{\"title\": \"Data Processing Addendum\", \"contract\": {\"clauses\": [{\"id\": \"scope\", \"title\": \"1. Scope\", \"body\": \"This addendum governs the processing of personal data...\"}], \"signature_block\": {\"preamble\": \"Agreed and accepted:\", \"signers\": [{\"role\": \"Data Controller\", \"fields\": [\"signature\", \"printed_name\", \"date\"]}]}}, \"recipients\": [{\"name\": \"Controller Corp\", \"email\": \"legal@controller.com\", \"role\": \"signer\"}]}'\n```\n\n---\n\n### saysigned_send_envelope\n\nSend a draft envelope for signing. Consumes 1 envelope from your quota.\n\n```json\n{\n  \"name\": \"saysigned_send_envelope\",\n  \"description\": \"Send a draft envelope for signing. For API recipients, generates access tokens. For email recipients, sends an invitation email with a consent link to doc.saysigned.com (no access_token in response). Consumes 1 envelope (free tier) or reports 1 metered event (paid). Returns 402 if free tier exhausted.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"envelope_id\": { \"type\": \"string\", \"format\": \"uuid\", \"description\": \"ID of the draft envelope to send\" }\n    },\n    \"required\": [\"envelope_id\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fenvelopes\u002F:id\u002Fsend` — requires `X-API-Key` header.\n\n**402 response (free tier exhausted):**\n```json\n{\"error\": \"Free tier envelope limit exhausted. Upgrade to a paid plan.\"}\n```\n\n---\n\n### saysigned_sign\n\nSign an envelope as a recipient.\n\n```json\n{\n  \"name\": \"saysigned_sign\",\n  \"description\": \"Sign an envelope as a recipient. Provide the access_token from the send response as a query parameter. No API key needed — the token is the auth. Records IP, user-agent, and timestamp in the audit trail.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"envelope_id\": { \"type\": \"string\", \"format\": \"uuid\" },\n      \"recipient_id\": { \"type\": \"string\", \"format\": \"uuid\" },\n      \"access_token\": { \"type\": \"string\", \"description\": \"128-char hex token from the send response\" },\n      \"signature_data\": {\n        \"type\": \"object\",\n        \"description\": \"Signature metadata\",\n        \"properties\": {\n          \"full_name\": { \"type\": \"string\" },\n          \"title\": { \"type\": \"string\" },\n          \"company\": { \"type\": \"string\" }\n        },\n        \"required\": [\"full_name\"]\n      }\n    },\n    \"required\": [\"envelope_id\", \"recipient_id\", \"access_token\", \"signature_data\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fenvelopes\u002F:id\u002Frecipients\u002F:rid\u002Fsign` with `X-Access-Token: TOKEN` header (recommended) or `?access_token=TOKEN` query parameter. No API key needed.\n\n---\n\n### saysigned_decline\n\nDecline to sign an envelope.\n\n```json\n{\n  \"name\": \"saysigned_decline\",\n  \"description\": \"Decline to sign an envelope as a recipient. Optionally provide a reason.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"envelope_id\": { \"type\": \"string\", \"format\": \"uuid\" },\n      \"recipient_id\": { \"type\": \"string\", \"format\": \"uuid\" },\n      \"access_token\": { \"type\": \"string\" },\n      \"reason\": { \"type\": \"string\", \"description\": \"Reason for declining (optional)\" }\n    },\n    \"required\": [\"envelope_id\", \"recipient_id\", \"access_token\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fenvelopes\u002F:id\u002Frecipients\u002F:rid\u002Fdecline` with `X-Access-Token: TOKEN` header (recommended) or `?access_token=TOKEN` query parameter. No API key needed.\n\n---\n\n### saysigned_get_envelope\n\nGet envelope details and recipient status.\n\n```json\n{\n  \"name\": \"saysigned_get_envelope\",\n  \"description\": \"Get full details of an envelope including status, contract content, and recipient statuses.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"envelope_id\": { \"type\": \"string\", \"format\": \"uuid\" }\n    },\n    \"required\": [\"envelope_id\"]\n  }\n}\n```\n\n**REST:** `GET \u002Fenvelopes\u002F:id` — requires `X-API-Key` header.\n\n---\n\n### saysigned_void_envelope\n\nVoid (cancel) an envelope.\n\n```json\n{\n  \"name\": \"saysigned_void_envelope\",\n  \"description\": \"Void an envelope that has been sent but not yet completed. Cannot void completed envelopes.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"envelope_id\": { \"type\": \"string\", \"format\": \"uuid\" },\n      \"reason\": { \"type\": \"string\", \"description\": \"Reason for voiding\" }\n    },\n    \"required\": [\"envelope_id\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fenvelopes\u002F:id\u002Fvoid` — requires `X-API-Key` header.\n\n---\n\n### saysigned_verify\n\nCryptographically verify an envelope. Public — no authentication required.\n\n```json\n{\n  \"name\": \"saysigned_verify\",\n  \"description\": \"Verify the cryptographic integrity of an envelope. Checks the hash chain audit trail and RFC 3161 timestamp. Public endpoint — no API key needed.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"envelope_id\": { \"type\": \"string\", \"format\": \"uuid\" }\n    },\n    \"required\": [\"envelope_id\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fverify`\n\nSee the [end-to-end example](#step-5--verify-public-no-auth-needed) above for the real response format.\n\n---\n\n### saysigned_get_audit_trail\n\nGet the full hash-chain audit trail for an envelope.\n\n```json\n{\n  \"name\": \"saysigned_get_audit_trail\",\n  \"description\": \"Get the complete cryptographic audit trail for an envelope, including hash chain verification status.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"envelope_id\": { \"type\": \"string\", \"format\": \"uuid\" }\n    },\n    \"required\": [\"envelope_id\"]\n  }\n}\n```\n\n**REST:** `GET \u002Fenvelopes\u002F:id\u002Faudit-trail` — requires `X-API-Key` header.\n\n---\n\n### saysigned_get_profile\n\nGet your agent profile and current usage.\n\n```json\n{\n  \"name\": \"saysigned_get_profile\",\n  \"description\": \"Get your agent profile, plan details, and current usage statistics.\",\n  \"inputSchema\": { \"type\": \"object\", \"properties\": {} }\n}\n```\n\n**REST:** `GET \u002Fagents\u002Fme` — requires `X-API-Key` header.\n\n---\n\n### saysigned_billing_setup\n\nUpgrade from free tier to a paid plan. **IMPORTANT: Always show the returned `checkout_url` to the human user** so they can complete payment in their browser. Never silently consume the URL.\n\n```json\n{\n  \"name\": \"saysigned_billing_setup\",\n  \"description\": \"Upgrade to a paid plan. Creates a Stripe customer and returns a checkout URL. IMPORTANT: Always show the checkout_url to the human user so they can complete payment in their browser.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"plan\": {\n        \"type\": \"string\",\n        \"enum\": [\"payg\", \"commit_500\", \"commit_2000\"],\n        \"description\": \"Plan to upgrade to. payg = $0.65\u002Fenv, commit_500 (Pro) = $225\u002Fmo for 500 env, commit_2000 (Business) = $600\u002Fmo for 2000 env.\"\n      }\n    },\n    \"required\": [\"plan\"]\n  }\n}\n```\n\n**REST:** `POST \u002Fbilling\u002Fsetup` — requires `X-API-Key` header.\n\n---\n\n### saysigned_get_usage\n\nGet current billing period usage.\n\n```json\n{\n  \"name\": \"saysigned_get_usage\",\n  \"description\": \"Get envelope usage for the current billing period, including count, cost, and plan details.\",\n  \"inputSchema\": { \"type\": \"object\", \"properties\": {} }\n}\n```\n\n**REST:** `GET \u002Fbilling\u002Fusage` — requires `X-API-Key` header.\n\n---\n\n## Available Templates\n\nDiscover templates programmatically:\n\n```bash\n# List all templates\ncurl https:\u002F\u002Fapi.saysigned.com\u002Ftemplates\n\n# Get template details with variable schema\ncurl https:\u002F\u002Fapi.saysigned.com\u002Ftemplates\u002Fnda_mutual_v1\n```\n\n### nda_mutual_v1 — Mutual Non-Disclosure Agreement\n\nStandard mutual NDA. Required variables: `disclosing_party_name`, `receiving_party_name`, `effective_date`, `purpose`, `governing_law_state`. Optional: `term_years` (default: 2), `non_solicitation` (default: false), etc.\n\n### service_agreement_v1 — Professional Services Agreement\n\nProfessional services contract. Required variables: `client_name`, `provider_name`, `effective_date`, `scope_of_services`, `compensation_model`, `governing_law_state`. Supports 4 compensation models: `fixed`, `hourly`, `milestone`, `retainer`.\n\n---\n\n## Webhook Events\n\nConfigure your `webhook_url` during registration to receive real-time notifications.\n\n| Event | Description |\n|-------|-------------|\n| `recipient.delivered` | Envelope sent, recipient notified (API recipients include `access_token`; email recipients do not) |\n| `recipient.email_sent` | Invitation email dispatched to human recipient |\n| `recipient.viewed` | Human recipient opened the consent page |\n| `recipient.signed` | Recipient completed signing |\n| `recipient.declined` | Recipient declined to sign |\n| `envelope.completed` | All signers done, timestamp anchored |\n| `envelope.declined` | A recipient declined |\n| `envelope.voided` | Agent voided the envelope |\n\n### Webhook Payload\n\n```json\n{\n  \"event\": \"recipient.signed\",\n  \"envelope_id\": \"env_...\",\n  \"timestamp\": \"2026-02-01T12:00:00Z\",\n  \"data\": {\n    \"recipient_id\": \"rec_...\",\n    \"recipient_name\": \"Alice Chen\",\n    \"recipient_email\": \"alice@acme.com\"\n  }\n}\n```\n\n### Verifying Webhook Signatures\n\nEvery webhook includes an `X-Signature-256` header containing `sha256=\u003CHMAC>`. Verify it:\n\n```python\nimport hmac, hashlib\n\ndef verify_webhook(body: bytes, secret: str, signature_header: str) -> bool:\n    expected = \"sha256=\" + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()\n    return hmac.compare_digest(expected, signature_header)\n```\n\n---\n\n## Common Workflows\n\n### Two-Party NDA\n\n```\n1. POST \u002Fenvelopes (template_id: \"nda_mutual_v1\", 2 signer recipients)\n2. POST \u002Fenvelopes\u002F:id\u002Fsend\n3. Party A signs: POST \u002Fenvelopes\u002F:id\u002Frecipients\u002F:r1\u002Fsign (X-Access-Token header)\n4. Party B signs: POST \u002Fenvelopes\u002F:id\u002Frecipients\u002F:r2\u002Fsign (X-Access-Token header)\n5. → envelope.completed webhook fires, RFC 3161 timestamp anchored\n6. POST \u002Fverify to confirm integrity\n```\n\n### Service Agreement with CC\n\n```\n1. POST \u002Fenvelopes (template_id: \"service_agreement_v1\", 2 signers + 1 CC)\n2. POST \u002Fenvelopes\u002F:id\u002Fsend\n3. Both signers sign (in any order)\n4. CC recipient receives notifications but doesn't sign\n5. → envelope.completed on last signature\n```\n\n### Handling Declines\n\n```\n1. Recipient declines: POST \u002Fenvelopes\u002F:id\u002Frecipients\u002F:rid\u002Fdecline\n2. → recipient.declined webhook fires\n3. → envelope.declined webhook fires (envelope status → declined)\n4. Create a new envelope with revised terms if needed\n```\n\n### Human Recipient Flow\n\n```\n1. POST \u002Fenvelopes (set delivery_method: \"email\" on human recipients)\n2. POST \u002Fenvelopes\u002F:id\u002Fsend → invitation email sent to human\n3. Human opens email → clicks \"Review & Give Consent\" link\n4. Human reviews contract at doc.saysigned.com → gives consent or declines\n5. → recipient.signed or recipient.declined webhook fires\n6. Envelope auto-completes when all signers consent\n7. Human receives confirmation email with 14-day document viewing link\n```\n\n### Polling for Completion\n\nIf you don't use webhooks, poll for envelope completion:\n\n```\n1. Call GET \u002Fenvelopes\u002F:id (or saysigned_get_envelope) to check status\n2. Poll every 5-10 seconds\n3. Terminal states: completed, declined, voided\n4. Max recommended wait: 24 hours\n```\n\n---\n\n## Error Handling\n\n| Status | Meaning | What to Do |\n|--------|---------|------------|\n| 400 | Bad request \u002F validation error | Check request body against schema |\n| 401 | Invalid or missing API key | Verify X-API-Key header |\n| 402 | Free tier exhausted | Call `POST \u002Fbilling\u002Fsetup` and show the `checkout_url` to the human user |\n| 404 | Resource not found | Check envelope\u002Frecipient IDs |\n| 409 | Invalid state transition | Check envelope\u002Frecipient status first |\n| 429 | Rate limited | Back off and retry |\n| 500 | Server error | Retry with exponential backoff |\n\n---\n\n## Security Notes\n\n- **API keys** are shown once at creation. Store securely. Rotate or delete keys that are no longer needed.\n- **Config file security** — API keys stored in MCP config files should have appropriate file permissions. Limit access to the config directory.\n- **Access tokens** are per-recipient, per-envelope. Do not reuse. Tokens are 128-character hex strings with no expiration — treat them as secrets for the duration of the signing flow.\n- **Webhook secrets** are per-agent. Verify every webhook signature.\n- All connections require **TLS** (HTTPS). Verify TLS certificates for `api.saysigned.com`, `mcp.saysigned.com`, and `doc.saysigned.com`.\n- API keys are stored as **SHA-256 hashes** — SaySigned never stores plaintext keys.\n- **URL tokens** (email recipients) are 32-char HMAC-derived tokens, one-time use, cleared after consent.\n- **CSRF protection** on consent\u002Fdecline forms — tokens bound to recipient ID, expire after 4 hours.\n- **Rate limiting** on consent pages — 10 URL attempts per 15 min per IP, 3 form submissions per 5 min per recipient.\n- **Sandboxing recommended** — If running in an untrusted environment, enable logging\u002Fmonitoring of config changes and outbound connections.\n\n---\n\n## Legal Context\n\n- **ESIGN Act** (15 U.S.C. § 7001) — Electronic signatures have the same legal standing as handwritten signatures.\n- **UETA Section 14** — Explicitly authorizes electronic agents to form contracts and conduct transactions.\n- **Attribution chain** — Every signature records: who (name, email), when (timestamp), how (API, IP address, user-agent), and what (contract hash).\n- **RFC 3161 timestamp** — Independent proof from DigiCert that the envelope was completed at a specific time.\n- **Hash chain** — Tamper-evident audit trail where each entry links to the previous via SHA-256.\n- **ESIGN mandatory disclosures** — four pre-consent disclosures displayed to human recipients: right to paper copies, right to withdraw consent, scope of consent (single document), and hardware\u002Fsoftware requirements.\n- **AI-generated contract disclosure** — if the contract was created from a template, a notice is displayed: \"This document was prepared using automated tools based on the sender's inputs.\"\n\n---\n\n## Pricing\n\n| Plan | Price | Envelopes |\n|------|-------|-----------|\n| Free | $0\u002Fmo | 5\u002Fmonth |\n| Pay-as-you-go | $0.65\u002Fenvelope | Unlimited |\n| Pro | $225\u002Fmo | 500 included, overage $0.45\u002Fenv |\n| Business | $600\u002Fmo | 2,000 included, overage $0.30\u002Fenv |\n| Enterprise | Custom | 10,000+\u002Fmonth |\n\nUpgrade anytime: `POST \u002Fbilling\u002Fsetup` with `{\"plan\": \"payg\"}`, `{\"plan\": \"commit_500\"}`, or `{\"plan\": \"commit_2000\"}`. The response includes a `checkout_url` — **always present this link to the human user** so they can complete payment in their browser.\n",{},"master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fs\u002Fsaysigned",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill saysigned",{"tool":37,"command":38},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill saysigned",{"tool":40,"command":41},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill saysigned","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fs\u002Fsaysigned\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]