{
  "name": "Wordsmith",
  "description": "Wordsmith is the legal AI platform built exclusively for in-house legal teams. The Public API exposes Wordsmith's legal assistant capabilities — question answering with legal context, document upload and review, playbook and template management, and asynchronous job workflows — so AI agents and MCP clients can integrate contract review, drafting, research, and intake directly into their own surfaces.",
  "version": "1.0",
  "publisher": {
    "name": "Wordsmith AI",
    "url": "https://wordsmith.ai"
  },
  "documentation_url": "https://wordsmithai.mintlify.app/",
  "endpoint_url": "https://mcp.wordsmith.ai",
  "api_base_url": "https://api.wordsmith.ai/api/v1",
  "authentication": {
    "type": "bearer",
    "token_prefix": "sk-ws-api1-",
    "documentation_url": "https://wordsmithai.mintlify.app/authentication"
  },
  "capabilities": [
    {
      "name": "ask_question",
      "title": "Ask a legal question",
      "description": "Submit a natural-language legal question to a Wordsmith assistant and get an AI-powered answer grounded in your playbooks, templates, and optional attachments. Supports sync and async execution modes.",
      "endpoint": "POST /assistants/{assistant_id}/questions",
      "documentation_url": "https://wordsmithai.mintlify.app/api-reference/assistants/create-question"
    },
    {
      "name": "get_question_status",
      "title": "Get question status",
      "description": "Poll the status of an async question session and retrieve the final answer once processing completes.",
      "endpoint": "GET /assistants/{assistant_id}/questions/{session_id}",
      "documentation_url": "https://wordsmithai.mintlify.app/api-reference/assistants/get-question-status"
    },
    {
      "name": "list_assistants",
      "title": "List assistants",
      "description": "Enumerate the assistants available to the authenticated customer.",
      "endpoint": "GET /assistants",
      "documentation_url": "https://wordsmithai.mintlify.app/api-reference/assistants/list-assistants"
    },
    {
      "name": "upload_file",
      "title": "Upload a document for analysis",
      "description": "Request a signed upload URL for a contract or other document, then attach the resulting upload job to a question for AI review, redlining, or summarization.",
      "endpoint": "POST /files/upload-url",
      "documentation_url": "https://wordsmithai.mintlify.app/api-reference/files/upload-url"
    },
    {
      "name": "list_playbooks",
      "title": "List playbooks",
      "description": "Retrieve the customer's configured playbooks so an agent can reference them by ID when asking review questions.",
      "endpoint": "GET /playbooks",
      "documentation_url": "https://wordsmithai.mintlify.app/api-reference/playbooks/list-playbooks"
    },
    {
      "name": "list_templates",
      "title": "List templates",
      "description": "Retrieve the customer's drafting templates for use in structured document generation.",
      "endpoint": "GET /templates",
      "documentation_url": "https://wordsmithai.mintlify.app/api-reference/templates/list-templates"
    },
    {
      "name": "get_current_user",
      "title": "Get current user",
      "description": "Return the authenticated user and customer context for the API key in use.",
      "endpoint": "GET /me",
      "documentation_url": "https://wordsmithai.mintlify.app/api-reference/user/get-me"
    },
    {
      "name": "webhooks",
      "title": "Webhook callbacks",
      "description": "Register a callback_url on async questions to receive completion notifications via HTTP POST instead of polling.",
      "documentation_url": "https://wordsmithai.mintlify.app/webhooks"
    }
  ],
  "rate_limits": {
    "description": "API usage is subject to subscription-based rate limits. Contact Wordsmith for enterprise limits.",
    "documentation_url": "https://wordsmithai.mintlify.app/introduction"
  },
  "contact": {
    "support_email": "support@wordsmith.ai",
    "signup_url": "https://app.wordsmith.ai"
  },
  "_comment": "JSON does not allow inline comments. See PRODUCTION_CHECKLIST.md.",
  "_todo_endpoint": "Replace endpoint_url 'https://mcp.wordsmith.ai' with the live MCP endpoint before production deploy. See PRODUCTION_CHECKLIST.md."
}