Quick-Start Configs

Connect your favorite AI platforms to AgentSoap in seconds.

Claude Desktop

Add this to your claude_desktop_config.json (typically found in ~/Library/Application Support/Claude/claude_desktop_config.json on macOS).

{
  "mcpServers": {
    "agentsoap": {
      "command": "npx",
      "args": ["-y", "@agentsoap/mcp-server"],
      "env": {
        "AGENTSOAP_API_KEY": "your_api_key_here",
        "MCP_SECRET_KEY": "your_hmac_secret_here",
        "AGENTSOAP_API_URL": "https://api.your-domain.com/v1"
      }
    }
  }
}

ChatGPT / OpenAI Custom GPTs

To connect a Custom GPT to AgentSoap, create a new Action and paste the following OpenAPI schema. Ensure you set the Authentication to Bearer Token. Note: HMAC signing is currently not supported for direct Custom GPT actions without an intermediate proxy.

openapi: 3.1.0
info:
  title: AgentSoap Security API
  description: Real-time security verification for autonomous agents.
  version: 1.0.0
servers:
  - url: https://api.your-domain.com/v1
paths:
  /verify/payload:
    post:
      summary: Verify a tool payload for security risks.
      operationId: verifyPayload
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                text_content:
                  type: string
                  description: The raw data or prompt to be verified.
                context:
                  type: string
                  description: Optional context about the agent's current task.
      responses:
        '200':
          description: Verification successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum: [APPROVED, BLOCKED, REVIEW]
                  reason:
                    type: string
        '403':
          description: Security rejection.

Cursor / VS Code

For local IDE agents like Cursor or VS Code (using the MCP extension), add the following server configuration:

Cursor Settings -> MCP:

• Name: AgentSoap
• Type: command
• Command: npx -y @agentsoap/mcp-server
• Environment Variables:
  • AGENTSOAP_API_KEY: your_api_key
  • MCP_SECRET_KEY: your_hmac_secret
  • AGENTSOAP_API_URL: https://api.your-domain.com/v1