# Oksign — how to use (mcp.ai)

Connect your Oksign account and use 17 tools for e-signatures straight from your AI agent. Connect with your own API key. Sign online contracts, purchase orders, forms, you name it. Simple and legal.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_oksign?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `oksign_briefcase_remove`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/oksign`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/oksign/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/oksign/briefcase/remove` — Tool to remove a previously created briefcase from OKSign platform. Use when you need to delete a briefcase that is no longer needed. The briefcase is identified by the token received when it was crea
  - body: { docid: string }
- `POST https://api.mcp.ai/api/oksign/briefcase/retrieve` — Tool to retrieve a previously uploaded briefcase tokeninfo for consultation. Use when you need to examine bundled document properties and signer requirements without re-creating the briefcase.
  - body: { docid: string }
- `POST https://api.mcp.ai/api/oksign/contacts/remove` — Tool to remove specified contacts from the account's contact list. Use when you need to delete one or more contacts by providing their name and email.
  - body: { contacts: object[] }
- `POST https://api.mcp.ai/api/oksign/contacts/retrieve` — Tool to retrieve the list of contacts stored in the account. Use when you need to access all contacts with their details including name, email, mobile number, and role.
- `POST https://api.mcp.ai/api/oksign/contacts/upload` — Tool to insert or update contact information in the account's contact list. Use when you need to add new contacts or update existing ones with details like name, email, phone, mobile, address, company
  - body: { contacts: object[] }
- `POST https://api.mcp.ai/api/oksign/credits/retrieve` — Tool to retrieve account credit balance and storage information. Use when you need to check available credits or storage capacity.
- `POST https://api.mcp.ai/api/oksign/document/exists` — Tool to check if a signed or unsigned document still exists on the OKSign platform. Use when you need to verify document availability before performing operations.
  - body: { doc_id: string }
- `POST https://api.mcp.ai/api/oksign/document/remove` — Tool to remove a signed or unsigned document from the OKSign platform. Use when you need to delete a document and its signed copies from storage. Note: If document is removed immediately after signing
  - body: { doc_id: string }
- `POST https://api.mcp.ai/api/oksign/document/upload` — Tool to upload a PDF or Word document to OKSign platform for completion and/or signing. Use when you need to add a new document that requires signatures. Maximum file size is 10 MB. Supported formats:
  - body: { document: object }
- `POST https://api.mcp.ai/api/oksign/editorexpress/create` — Tool to invoke the OKSign Editor Express for modifying documents and form descriptors. Use when you need to open documents in an interactive editor where users can add signature fields, form fields, a
  - body: { list: string[], show_me_signer?: boolean, show_teammembers?: boolean, show_signing_options?: boolean, show_anonymous_signers?: boolean }
- `POST https://api.mcp.ai/api/oksign/formdesc/upload` — Tool to upload form descriptor defining signature fields and other field types to a document. Use when you need to add form fields, signature areas, and configure signing workflows for a document.
  - body: { logo?: string, docid: string, fields: object[], assignto?: string, filename?: string, reusable: boolean, signersinfo: object[], sendtomeonly?: boolean, notifications?: object, sendtomeemail?: string }
- `POST https://api.mcp.ai/api/oksign/get/active/documents` — Tool to retrieve all active document IDs and properties from OKsign account. Use when you need to list documents visible in the Active Documents tab. Note: Rate limited to 1 request per 3 minutes.
- `POST https://api.mcp.ai/api/oksign/linked/list/retrieve` — Tool to retrieve the list of linked signed or source document IDs related to a specific document. Use when you need to find linked documents (either the signed version of a source document, or the sou
  - body: { doc_id: string }
- `POST https://api.mcp.ai/api/oksign/notifications/upload` — Tool to upload notifications defining email(s) and/or SMS(es) to be sent to signer(s) with signing links. Use when you need to send notification emails or SMS messages to document signers.
  - body: { signersinfo?: object[], notifications: object, x-oksign-docid: string }
- `POST https://api.mcp.ai/api/oksign/org/token/info/update` — Tool to update organizational token information and settings for the account. Use when you need to configure or modify callback URL, webhook URL, or return URL for the organization's token.
  - body: { returnurl?: string, webhookurl?: string, callbackurl?: string }
- `POST https://api.mcp.ai/api/oksign/signexpress/remove` — Tool to remove a previously uploaded SignExpress tokeninfo JSONObject from the OKSign platform. Use when you need to clean up or invalidate a SignExpress token that was created for sign button integra
  - body: { x-oksign-token: string }
- `POST https://api.mcp.ai/api/oksign/users/retrieve` — Tool to retrieve the list of users associated with the OkSign account. Use when you need to get all users in an account.

## Example prompts
- "What can I do in Oksign?"
- "Show me a summary of my Oksign account"

## More
- Page: https://mcp.ai/oksign
- Agent spec (llms.txt): https://mcp.ai/oksign/llms.txt
- Postman collection: https://mcp.ai/oksign/postman.json