Search Apollo people

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READapollo.apollo_leads_people_search

• Contract tier: agent_ready
• Risk: read
• Catalog version: 1.0.2
• Descriptor hash: 7bdad20646daf6cbf83608d5bc62ef90de7c8ab03dba6e1d42ce59627aaa878e

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "apollo-apollo-leads-people-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_people_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-people-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_people_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-people-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_people_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-people-search-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.apollo_leads_people_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_people_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."
}