.codex-plugin/plugin.json

{
  "name": "signatureapi",
  "version": "1.3.0",
  "description": "SignatureAPI is an e-signature API for developers: send documents for signature, embed signing in your app, and track progress with webhooks. This plugin adds skills to design, build and troubleshoot your integration and answer questions from the docs, plus the hosted MCP server.",
  "author": {
    "name": "Superposition Labs, Inc.",
    "email": "support@signatureapi.com",
    "url": "https://signatureapi.com"
  },
  "homepage": "https://signatureapi.com",
  "license": "MIT",
  "keywords": [
    "e-signature",
    "esignature",
    "electronic-signature",
    "digital-signature",
    "document-signing",
    "signature-api",
    "webhooks",
    "mcp",
    "signatureapi"
  ],
  "skills": "./skills/",
  "mcpServers": "./.codex-plugin/mcp-servers.json",
  "interface": {
    "displayName": "SignatureAPI",
    "shortDescription": "E-signatures for developers",
    "longDescription": "SignatureAPI is an e-signature API for developers: send documents for signature, embed signing in your app, and track progress with webhooks. Four skills design the signing flow, build and test the integration, diagnose one that misbehaves, and answer questions from the current docs. Test mode sends no real email. The hosted MCP server, signed in with OAuth, lets the agent create and inspect envelopes directly.",
    "developerName": "Superposition Labs, Inc.",
    "category": "Developer Tools",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "websiteURL": "https://signatureapi.com",
    "supportURL": "https://signatureapi.com/support",
    "privacyPolicyURL": "https://signatureapi.com/docs/legal/terms/openai-plugin-privacy",
    "termsOfServiceURL": "https://signatureapi.com/terms",
    "defaultPrompt": [
      "Add e-signatures to this app with SignatureAPI.",
      "Send a test envelope and show me the signing link.",
      "Why is my envelope stuck in processing?"
    ],
    "brandColor": "#2563EB",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/icon.svg",
    "screenshots": []
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Identify the connected review account and inspect its test-mode inventory; works with an empty account.",
              "prompt": "Which SignatureAPI account is connected? Show up to five in-progress test signature requests.",
              "expected_behavior": "Returns the connected account name and available modes; lists up to five in-progress test requests or states that none exist.",
              "tools_triggered": "whoami, list_envelopes"
            },
            {
              "description": "Create a synthetic test request using the public PDF fixture; requires an authenticated test-capable account.",
              "prompt": "Create a test signature request titled OpenAI review for Alex Morgan at alex@example.com using https://example-files-signatureapi-dev.s3.us-east-2.amazonaws.com/no-placeholders.pdf. Place a required signature on page 1 at top 500 and left 72. Do not send live email.",
              "expected_behavior": "Creates a test envelope with the supplied document and signer, returns its identifier and status, and explains that test emails are recorded, not sent.",
              "tools_triggered": "create_envelope"
            },
            {
              "description": "Inspect the envelope created in the preceding case after processing; no signer action is required.",
              "prompt": "For the OpenAI review test request we just created, check its current status and events, then show the test signing email and its ceremony link when available.",
              "expected_behavior": "Reports the actual status and recent events, then returns the selected test signing-request email and ceremony link when available; reports processing state accurately.",
              "tools_triggered": "get_envelope, list_events, list_emails, get_email"
            },
            {
              "description": "Exercise irreversible controls using only the synthetic test envelope created above.",
              "prompt": "Cancel the OpenAI review test request we just created and permanently delete it. Ask me to confirm before deleting.",
              "expected_behavior": "Cancels the in-progress test request, waits for deletion confirmation, then reports deleted: true; does not act on any other envelope.",
              "tools_triggered": "cancel_envelope, delete_envelope"
            },
            {
              "description": "Inspect webhook configuration without requiring a public receiver or creating deliveries.",
              "prompt": "List my test-mode webhooks. If one exists, inspect recent delivery attempts for the first one and summarize the HTTP status and timing. Do not create, change, or retry anything.",
              "expected_behavior": "Lists configured test endpoints; reports when none exist, otherwise summarizes available HTTP status and timing for the first endpoint.",
              "tools_triggered": "list_webhooks, list_webhook_attempts"
            }
          ],
          "negative": [
            {
              "description": "An unrelated document summary does not need a signing workflow.",
              "prompt": "Summarize the attached garden-club newsletter in three sentences.",
              "expected_behavior": "Does not invoke SignatureAPI; document summarization alone is outside the plugin workflow."
            },
            {
              "description": "A calendar request is outside the supported workflow.",
              "prompt": "Add a reminder to water my plants tomorrow morning.",
              "expected_behavior": "Does not invoke SignatureAPI because this request concerns a reminder, not document signing."
            },
            {
              "description": "An image request is outside the supported workflow.",
              "prompt": "Draw a picture of a blue bicycle beside a tree.",
              "expected_behavior": "Does not invoke SignatureAPI because image creation does not require a signing workflow."
            }
          ]
        },
        "demo_recording_url": "https://pub-a1497b6ba2804e8ab872d1e3c152d7cd.r2.dev/chatgpt-demo.mp4"
      },
      "publication": {
        "release_notes": "SignatureAPI 1.3.0 includes four skills for integration design, implementation, troubleshooting, and documentation research. This submission removes plugin lifecycle hooks, configures the OpenAI review MCP endpoint, and includes five positive and three negative review test cases."
      }
    }
  },
  "apps": "./.app.json"
}