Search Apollo organizations

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READapollo.apollo_leads_organization_search

• Contract tier: agent_ready
• Risk: read
• Catalog version: 1.0.2
• Descriptor hash: 30240b4e09779705ee1c0ae6addc9ae2075039ead6b83312741d3f1cc89b77d7

Use this read-only workflow helper to search Apollo organizations with Apollo query parameters. It contacts Apollo but does not intentionally change workspace data and returns compact, normalized organization results with pagination metadata. Requires Portal grant and Apollo credentials.

Request Body

{
  "jsonrpc": "2.0",
  "id": "apollo-apollo-leads-organization-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_organization_search",
    "arguments": {
      "params": "",
      "compact": "",
      "max_items": ""
    }
  }
}

Arguments Schema

{
  "type": "object",
  "properties": {
    "params": {
      "anyOf": [
        {
          "type": "object",
          "description": "Apollo endpoint parameters.",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Apollo endpoint parameters."
    },
    "compact": {
      "anyOf": [
        {
          "type": "boolean",
          "description": "Override the server default for token-efficient list truncation."
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Override the server default for token-efficient list truncation."
    },
    "max_items": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "description": "Maximum result items returned when compact mode is enabled."
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Maximum result items returned when compact mode is enabled."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the requested operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "object",
              "additionalProperties": true
            },
            {
              "type": "array",
              "items": {}
            },
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            }
          ],
          "description": "Normalized provider or navigation result."
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Normalized provider or navigation result."
    },
    "meta": {
      "type": "object",
      "description": "Safe request, pagination, and truncation metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "description": "Safe error details when ok is false.",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Safe error details when ok is false."
    }
  },
  "description": "Apollo MCP normalized response envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "apollo-apollo-leads-organization-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_organization_search",
    "arguments": {
      "params": "",
      "compact": "",
      "max_items": ""
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "apollo-apollo-leads-organization-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_organization_search",
    "arguments": {
      "params": "",
      "compact": "",
      "max_items": ""
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "apollo-apollo-leads-organization-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_organization_search",
    "arguments": {
      "params": "",
      "compact": "",
      "max_items": ""
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool apollo.apollo_leads_organization_search executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}