Apollo.io MCP Server

Instructions

Implementation Reference

• src/apollo_mcp_server.py:299-328 (handler)

  The core handler function for the 'create_account' tool. Decorated with @mcp.tool() for automatic registration in FastMCP. Posts account creation data to Apollo.io API.

  @mcp.tool()
  async def create_account(
      name: str,
      domain: Optional[str] = None,
      phone_number: Optional[str] = None,
      raw_address: Optional[str] = None
  ) -> Dict[str, Any]:
      """
      Create a new account in Apollo.io.
      
      This tool creates a new account with the provided information.
      The domain and address will be intelligently parsed for additional data.
      """
      endpoint = "/v1/accounts"
      
      data = {"name": name}
      if domain:
          data["domain"] = domain
      if phone_number:
          data["phone_number"] = phone_number
      if raw_address:
          data["raw_address"] = raw_address
      
      try:
          result = await apollo_client.make_request("POST", endpoint, data=data)
          return result
      except httpx.HTTPStatusError as e:
          return {"error": f"API request failed: {e.response.status_code} {e.response.text}"}
      except Exception as e:
          return {"error": f"Request failed: {str(e)}"}