iflow-mcp_edwardchoh-apollo-io-mcp-server 0.1.0__tar.gz

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/LICENSE

@@ -0,0 +1,12 @@
+
+The MIT License (MIT)
+
+Copyright © 2025 Edward Choh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Fork this project to create your own MIT license that you can always link to.

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_edwardchoh-apollo-io-mcp-server
+Version: 0.1.0
+Summary: MCP server that exposes the Apollo.io API functionalities as tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: python-dotenv
+Requires-Dist: httpx
+Dynamic: license-file
+
+# Apollo.io MCP Server
+
+This project provides an MCP server that exposes the Apollo.io API functionalities as tools. It allows you to interact with the Apollo.io API using the Model Context Protocol (MCP).
+
+## Overview
+
+The project consists of the following main components:
+
+- `apollo_client.py`: Defines the `ApolloClient` class, which is used to interact with the Apollo.io API. It includes methods for people enrichment, organization enrichment, people search, organization search, and organization job postings.
+- `server.py`: Defines the FastMCP server, which exposes the Apollo.io API functionalities as tools. It uses the `ApolloClient` class defined in `apollo_client.py` to interact with the API.
+- `apollo/`: Contains the data models for the Apollo.io API, such as `PeopleEnrichmentQuery`, `OrganizationEnrichmentQuery`, `PeopleSearchQuery`, `OrganizationSearchQuery`, and `OrganizationJobPostingsQuery`.
+
+## Functionalities
+
+The following functionalities are exposed as MCP tools:
+
+-   `people_enrichment`: Use the People Enrichment endpoint to enrich data for 1 person.
+-   `organization_enrichment`: Use the Organization Enrichment endpoint to enrich data for 1 company.
+-   `people_search`: Use the People Search endpoint to find people.
+-   `organization_search`: Use the Organization Search endpoint to find organizations.
+-   `organization_job_postings`: Use the Organization Job Postings endpoint to find job postings for a specific organization.
+
+## Usage
+
+To use this MCP server, you need to:
+
+1. Set the `APOLLO_IO_API_KEY` environment variable with your Apollo.io API key. Or create '.env' file in the project root with `APOLLO_IO_API_KEY`.
+2. Get dependencies: `uv sync`
+3. Run the `uv run mcp run server.py`
+
+## Data Models
+
+The `apollo/` directory contains the data models for the Apollo.io API. These models are used to define the input and output of the MCP tools.
+
+- `apollo/people.py`: Defines the data models for the People Enrichment endpoint.
+- `apollo/organization.py`: Defines the data models for the Organization Enrichment endpoint.
+- `apollo/people_search.py`: Defines the data models for the People Search endpoint.
+- `apollo/organization_search.py`: Defines the data models for the Organization Search endpoint.
+- `apollo/organization_job_postings.py`: Defines the data models for the Organization Job Postings endpoint.
+
+## Testing
+
+To test, set `APOLLO_IO_API_KEY` environment variable and run `uv run apollo_client.py`.
+
+## Usage with Claude for Desktop
+
+1. Configure Claude for Desktop to use these MCP servers by adding them to your `claude_desktop_config.json` file:
+
+```json
+{
+  "mcpServers": {
+    "apollo-io-mcp-server": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "run",
+        "mcp",
+        "run",
+        "path/to/apollo-io-mcp-server/server.py"
+      ]
+    }
+  }
+}
+```
+
+## Resources
+
+- [Apollo.io API Documentation](https://docs.apollo.io/reference/)
+- [MCP Protocol Documentation](https://github.com/modelcontextprotocol/mcp)
+- [Claude for Desktop Documentation](https://claude.ai/docs)

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/README.md

@@ -0,0 +1,70 @@
+# Apollo.io MCP Server
+
+This project provides an MCP server that exposes the Apollo.io API functionalities as tools. It allows you to interact with the Apollo.io API using the Model Context Protocol (MCP).
+
+## Overview
+
+The project consists of the following main components:
+
+- `apollo_client.py`: Defines the `ApolloClient` class, which is used to interact with the Apollo.io API. It includes methods for people enrichment, organization enrichment, people search, organization search, and organization job postings.
+- `server.py`: Defines the FastMCP server, which exposes the Apollo.io API functionalities as tools. It uses the `ApolloClient` class defined in `apollo_client.py` to interact with the API.
+- `apollo/`: Contains the data models for the Apollo.io API, such as `PeopleEnrichmentQuery`, `OrganizationEnrichmentQuery`, `PeopleSearchQuery`, `OrganizationSearchQuery`, and `OrganizationJobPostingsQuery`.
+
+## Functionalities
+
+The following functionalities are exposed as MCP tools:
+
+-   `people_enrichment`: Use the People Enrichment endpoint to enrich data for 1 person.
+-   `organization_enrichment`: Use the Organization Enrichment endpoint to enrich data for 1 company.
+-   `people_search`: Use the People Search endpoint to find people.
+-   `organization_search`: Use the Organization Search endpoint to find organizations.
+-   `organization_job_postings`: Use the Organization Job Postings endpoint to find job postings for a specific organization.
+
+## Usage
+
+To use this MCP server, you need to:
+
+1. Set the `APOLLO_IO_API_KEY` environment variable with your Apollo.io API key. Or create '.env' file in the project root with `APOLLO_IO_API_KEY`.
+2. Get dependencies: `uv sync`
+3. Run the `uv run mcp run server.py`
+
+## Data Models
+
+The `apollo/` directory contains the data models for the Apollo.io API. These models are used to define the input and output of the MCP tools.
+
+- `apollo/people.py`: Defines the data models for the People Enrichment endpoint.
+- `apollo/organization.py`: Defines the data models for the Organization Enrichment endpoint.
+- `apollo/people_search.py`: Defines the data models for the People Search endpoint.
+- `apollo/organization_search.py`: Defines the data models for the Organization Search endpoint.
+- `apollo/organization_job_postings.py`: Defines the data models for the Organization Job Postings endpoint.
+
+## Testing
+
+To test, set `APOLLO_IO_API_KEY` environment variable and run `uv run apollo_client.py`.
+
+## Usage with Claude for Desktop
+
+1. Configure Claude for Desktop to use these MCP servers by adding them to your `claude_desktop_config.json` file:
+
+```json
+{
+  "mcpServers": {
+    "apollo-io-mcp-server": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "run",
+        "mcp",
+        "run",
+        "path/to/apollo-io-mcp-server/server.py"
+      ]
+    }
+  }
+}
+```
+
+## Resources
+
+- [Apollo.io API Documentation](https://docs.apollo.io/reference/)
+- [MCP Protocol Documentation](https://github.com/modelcontextprotocol/mcp)
+- [Claude for Desktop Documentation](https://claude.ai/docs)

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/apollo/__init__.py

@@ -0,0 +1,5 @@
+from .organization_job_postings import *
+from .organization_search import *
+from .organization import *
+from .people_search import *
+from .people import *

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/apollo/organization.py

@@ -0,0 +1,141 @@
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel, Field
+
+class OrganizationEnrichmentQuery(BaseModel):
+    domain: str = Field(description="The domain of the company that you want to enrich. Do not include `www.`, the `@` symbol, or similar. Example: `apollo.io` or `microsoft.com`")
+
+class PrimaryPhone(BaseModel):
+    languages: Optional[List[str]] = Field(default=None, description="languages")
+    phone: Optional[str] = Field(default=None, description="phone")
+
+class FundingEvent(BaseModel):
+    id: str = Field(description="id")
+    date: str = Field(description="date")
+    news_url: Optional[str] = Field(default=None, description="news_url")
+    type: str = Field(description="type")
+    investors: str = Field(description="investors")
+    amount: str = Field(description="amount")
+    currency: str = Field(description="currency")
+
+class Account(BaseModel):
+    id: str = Field(description="id")
+    domain: str = Field(description="domain")
+    name: str = Field(description="name")
+    team_id: str = Field(description="team_id")
+    organization_id: str = Field(description="organization_id")
+    account_stage_id: Optional[str] = Field(default=None, description="account_stage_id")
+    source: str = Field(description="source")
+    original_source: str = Field(description="original_source")
+    creator_id: Optional[str] = Field(default=None, description="creator_id")
+    owner_id: str = Field(description="owner_id")
+    created_at: str = Field(description="created_at")
+    phone: str = Field(description="phone")
+    phone_status: str = Field(description="phone_status")
+    hubspot_id: Optional[str] = Field(default=None, description="hubspot_id")
+    salesforce_id: Optional[str] = Field(default=None, description="salesforce_id")
+    crm_owner_id: Optional[str] = Field(default=None, description="crm_owner_id")
+    parent_account_id: Optional[str] = Field(default=None, description="parent_account_id")
+    linkedin_url: Optional[str] = Field(default=None, description="linkedin_url")
+    sanitized_phone: str = Field(description="sanitized_phone")
+    account_playbook_statuses: List[Any] = Field(description="account_playbook_statuses")
+    account_rule_config_statuses: List[Any] = Field(description="account_rule_config_statuses")
+    existence_level: str = Field(description="existence_level")
+    label_ids: List[str] = Field(description="label_ids")
+    typed_custom_fields: Dict[str, Any] = Field(description="typed_custom_fields")
+    custom_field_errors: Dict[str, Any] = Field(description="custom_field_errors")
+    modality: str = Field(description="modality")
+    source_display_name: str = Field(description="source_display_name")
+    crm_record_url: Optional[str] = Field(default=None, description="crm_record_url")
+    intent_strength: Optional[str] = Field(default=None, description="intent_strength")
+    show_intent: bool = Field(description="show_intent")
+    has_intent_signal_account: bool = Field(description="has_intent_signal_account")
+    intent_signal_signal_account: Optional[str] = Field(default=None, description="intent_signal_signal_account")
+
+class DepartmentalHeadCount(BaseModel):
+    engineering: Optional[int] = Field(default=None, description="engineering")
+    operations: Optional[int] = Field(default=None, description="operations")
+    support: Optional[int] = Field(default=None, description="support")
+    marketing: Optional[int] = Field(default=None, description="marketing")
+    human_resources: Optional[int] = Field(default=None, description="human_resources")
+    sales: Optional[int] = Field(default=None, description="sales")
+    finance: Optional[int] = Field(default=None, description="finance")
+    consulting: Optional[int] = Field(default=None, description="consulting")
+    legal: Optional[int] = Field(default=None, description="legal")
+    arts_and_design: Optional[int] = Field(default=None, description="arts_and_design")
+    accounting: Optional[int] = Field(default=None, description="accounting")
+    business_development: Optional[int] = Field(default=None, description="business_development")
+    information_technology: Optional[int] = Field(default=None, description="information_technology")
+    education: Optional[int] = Field(default=None, description="education")
+    media_and_commmunication: Optional[int] = Field(default=None, description="media_and_commmunication")
+    product_management: Optional[int] = Field(default=None, description="product_management")
+    entrepreneurship: Optional[int] = Field(default=None, description="entrepreneurship")
+    data_science: Optional[int] = Field(default=None, description="data_science")
+    administrative: Optional[int] = Field(default=None, description="administrative")
+
+class CurrentTechnology(BaseModel):
+    uid: str = Field(description="uid")
+    name: str = Field(description="name")
+    category: str = Field(description="category")
+
+class IndustryTagHash(BaseModel):
+    information_technology_services: Optional[str] = Field(default=None, description="information_technology_services")
+
+class Organization(BaseModel):
+    id: Optional[str] = Field(default=None, description="id")
+    name: Optional[str] = Field(default=None, description="name")
+    website_url: Optional[str] = Field(default=None, description="website_url")
+    blog_url: Optional[str] = Field(default=None, description="blog_url")
+    angellist_url: Optional[str] = Field(default=None, description="angellist_url")
+    linkedin_url: Optional[str] = Field(default=None, description="linkedin_url")
+    twitter_url: Optional[str] = Field(default=None, description="twitter_url")
+    facebook_url: Optional[str] = Field(default=None, description="facebook_url")
+    primary_phone: Optional[PrimaryPhone] = Field(default=None, description="primary_phone")
+    languages: Optional[List[Any]] = Field(default=None, description="languages")
+    alexa_ranking: Optional[int] = Field(default=0, description="alexa_ranking")
+    phone: Optional[str] = Field(default=None, description="phone")
+    linkedin_uid: Optional[str] = Field(default=None, description="linkedin_uid")
+    founded_year: Optional[int] = Field(default=0, description="founded_year")
+    publicly_traded_symbol: Optional[str] = Field(default=None, description="publicly_traded_symbol")
+    publicly_traded_exchange: Optional[str] = Field(default=None, description="publicly_traded_exchange")
+    logo_url: Optional[str] = Field(default=None, description="logo_url")
+    crunchbase_url: Optional[str] = Field(default=None, description="crunchbase_url")
+    primary_domain: Optional[str] = Field(default=None, description="primary_domain")
+    industry: Optional[str] = Field(default=None, description="industry")
+    keywords: List[str] = Field(description="keywords")
+    estimated_num_employees: Optional[int] = Field(default=0, description="estimated_num_employees")
+    industries: List[str] = Field(description="industries")
+    secondary_industries: List[Any] = Field(description="secondary_industries")
+    snippets_loaded: bool = Field(default=True, description="snippets_loaded")
+    industry_tag_id: Optional[str] = Field(default=None, description="industry_tag_id")
+    industry_tag_hash: IndustryTagHash = Field(description="industry_tag_hash")
+    retail_location_count: Optional[int] = Field(default=0, description="retail_location_count")
+    raw_address: Optional[str] = Field(default=None, description="raw_address")
+    street_address: Optional[str] = Field(default=None, description="street_address")
+    city: Optional[str] = Field(default=None, description="city")
+    state: Optional[str] = Field(default=None, description="state")
+    postal_code: Optional[str] = Field(default=None, description="postal_code")
+    country: Optional[str] = Field(default=None, description="country")
+    owned_by_organization_id: Optional[str] = Field(default=None, description="owned_by_organization_id")
+    seo_description: Optional[str] = Field(default=None, description="seo_description")
+    short_description: Optional[str] = Field(default=None, description="short_description")
+    suborganizations: List[Any] = Field(description="suborganizations")
+    num_suborganizations: Optional[int] = Field(default=0, description="num_suborganizations")
+    annual_revenue_printed: Optional[str] = Field(default=None, description="annual_revenue_printed")
+    annual_revenue: Optional[int] = Field(default=0, description="annual_revenue")
+    total_funding: Optional[int] = Field(default=None, description="total_funding")
+    total_funding_printed: Optional[str] = Field(default=None, description="total_funding_printed")
+    latest_funding_round_date: Optional[str] = Field(default=None, description="latest_funding_round_date")
+    latest_funding_stage: Optional[str] = Field(default=None, description="latest_funding_stage")
+    funding_events: Optional[List[FundingEvent]] = Field(default=None, description="funding_events")
+    technology_names: List[str] = Field(description="technology_names")
+    current_technologies: List[CurrentTechnology] = Field(description="current_technologies")
+    org_chart_root_people_ids: List[str] = Field(description="org_chart_root_people_ids")
+    org_chart_sector: Optional[str] = Field(default=None, description="org_chart_sector")
+    org_chart_removed: bool = Field(default=True, description="org_chart_removed")
+    org_chart_show_department_filter: bool = Field(default=True, description="org_chart_show_department_filter")
+    account_id: Optional[str] = Field(default=None, description="account_id")
+    account: Optional[Account] = Field(default=None, description="account")
+    departmental_head_count: DepartmentalHeadCount = Field(description="departmental_head_count")
+
+class OrganizationEnrichmentResponse(BaseModel):
+    organization: Organization = Field(description="organization")

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/apollo/organization_job_postings.py

@@ -0,0 +1,18 @@
+from typing import Optional, List
+from pydantic import BaseModel, Field
+
+class OrganizationJobPostingsQuery(BaseModel):
+    organization_id: str = Field(description="The organization ID of the company for which you want to find job postings. Each company in the Apollo database is assigned a unique ID. To find IDs, call the [Organization Search endpoint](/reference/organization-search) and identify the values for `organization_id`. Example: `5e66b6381e05b4008c8331b8`")
+
+class OrganizationJobPosting(BaseModel):
+    id: str = Field(description="id")
+    title: str = Field(description="title")
+    url: str = Field(description="url")
+    city: Optional[str] = Field(default=None, description="city")
+    state: Optional[str] = Field(default=None, description="state")
+    country: str = Field(description="country")
+    last_seen_at: str = Field(description="last_seen_at")
+    posted_at: str = Field(description="posted_at")
+
+class OrganizationJobPostingsResponse(BaseModel):
+    organization_job_postings: List[OrganizationJobPosting] = Field(description="organization_job_postings")

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/apollo/organization_search.py

@@ -0,0 +1,72 @@
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel, Field
+
+class OrganizationSearchQuery(BaseModel):
+    organization_num_employees_ranges: Optional[List[str]] = Field(default=None, description="The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results. Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. Examples: `1,10`; `250,500`; `10000,20000`")
+    organization_locations: Optional[List[str]] = Field(default=None, description="The location of the company headquarters. You can search across cities, US states, and countries. If a company has several office locations, results are still based on the headquarters location. For example, if you search `chicago` but a company's HQ location is in `boston`, any Boston-based companies will not appearch in your search results, even if they match other parameters. To exclude companies based on location, use the `organization_not_locations` parameter. Examples: `texas`; `tokyo`; `spain`")
+    organization_not_locations: Optional[List[str]] = Field(default=None, description="Exclude companies from search results based on the location of the company headquarters. You can use cities, US states, and countries as locations to exclude. This parameter is useful for ensuring you do not prospect in an undesirable territory. For example, if you use `ireland` as a value, no Ireland-based companies will appear in your search results. Examples: `minnesota`; `ireland`; `seoul`")
+    revenue_range_min: Optional[int] = Field(default=None, description="Search for organizations based on their revenue. Use this parameter to set the lower range of organization revenue. Use the `revenue_range[max]` parameter to set the upper range of revenue. Do not enter currency symbols, commas, or decimal points in the figure. Example: `300000`")
+    revenue_range_max: Optional[int] = Field(default=None, description="Search for organizations based on their revenue. Use this parameter to set the upper range of organization revenue. Use the `revenue_range[min]` parameter to set the lower range of revenue. Do not enter currency symbols, commas, or decimal points in the figure. Example: `50000000`")
+    currently_using_any_of_technology_uids: Optional[List[str]] = Field(default=None, description="Find organizations based on the technologies they currently use. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by [downloading this CSV file](https://api.apollo.io/v1/auth/supported_technologies_csv). Use underscores (`_`) to replace spaces and periods for the technologies listed in the CSV file. Examples: `salesforce`; `google_analytics`; `wordpress_org`")
+    q_organization_keyword_tags: Optional[List[str]] = Field(default=None, description="Filter search results based on keywords associated with companies. For example, you can enter `mining` as a value to return only companies that have an association with the mining industry. Examples: `mining`; `sales strategy`; `consulting`")
+    q_organization_name: Optional[str] = Field(default=None, description="Filter search results to include a specific company name. If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted. For example, if you filter by the value `marketing`, a company called `NY Marketing Unlimited` would still be eligible as a search result, but `NY Market Analysis` would not be eligible. Example: `apollo` or `mining`")
+    organization_ids: Optional[List[str]] = Field(default=None, description="The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, identify the values for `organization_id` when you call this endpoint. Example: `5e66b6381e05b4008c8331b8`")
+    page: Optional[int] = Field(default=None, description="The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the `per_page` parameter to make search results for navigable and improve the performance of the endpoint. Example: `4`")
+    per_page: Optional[int] = Field(default=None, description="The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance. Use the `page` parameter to search the different pages of data. Example: `10`")
+
+class Breadcrumb(BaseModel):
+    label: str = Field(description="label")
+    signal_field_name: str = Field(description="signal_field_name")
+    value: str = Field(description="value")
+    display_name: str = Field(description="display_name")
+
+class PrimaryPhone(BaseModel):
+    number: str = Field(description="number")
+    source: str = Field(description="source")
+    sanitized_number: str = Field(description="sanitized_number")
+
+class Organization(BaseModel):
+    id: str = Field(description="id")
+    name: Optional[str] = Field(default=None, description="name")
+    website_url: Optional[str] = Field(default=None, description="website_url")
+    blog_url: Optional[str] = Field(default=None, description="blog_url")
+    angellist_url: Optional[str] = Field(default=None, description="angellist_url")
+    linkedin_url: Optional[str] = Field(default=None, description="linkedin_url")
+    twitter_url: Optional[str] = Field(default=None, description="twitter_url")
+    facebook_url: Optional[str] = Field(default=None, description="facebook_url")
+    primary_phone: Optional[PrimaryPhone] = Field(default=None, description="primary_phone")
+    languages: Optional[List[str]] = Field(default=None, description="languages")
+    alexa_ranking: Optional[int] = Field(default=0, description="alexa_ranking")
+    phone: Optional[str] = Field(default=None, description="phone")
+    linkedin_uid: Optional[str] = Field(default=None, description="linkedin_uid")
+    founded_year: Optional[int] = Field(default=0, description="founded_year")
+    publicly_traded_symbol: Optional[str] = Field(default=None, description="publicly_traded_symbol")
+    publicly_traded_exchange: Optional[str] = Field(default=None, description="publicly_traded_exchange")
+    logo_url: Optional[str] = Field(default=None, description="logo_url")
+    crunchbase_url: Optional[str] = Field(default=None, description="crunchbase_url")
+    primary_domain: Optional[str] = Field(default=None, description="primary_domain")
+    sanitized_phone: Optional[str] = Field(default=None, description="sanitized_phone")
+    owned_by_organization_id: Optional[str] = Field(default=None, description="owned_by_organization_id")
+    intent_strength: Optional[str] = Field(default=None, description="intent_strength")
+    show_intent: Optional[bool] = Field(default=None, description="show_intent")
+    has_intent_signal_account: Optional[bool] = Field(default=None, description="has_intent_signal_account")
+    intent_signal_account: Optional[str] = Field(default=None, description="intent_signal_account")
+
+class Pagination(BaseModel):
+    page: int = Field(default=0, description="page")
+    per_page: int = Field(default=0, description="per_page")
+    total_entries: int = Field(default=0, description="total_entries")
+    total_pages: int = Field(default=0, description="total_pages")
+
+class OrganizationSearchResponse(BaseModel):
+    breadcrumbs: Optional[List[Breadcrumb]] = Field(default=None, description="breadcrumbs")
+    partial_results_only: Optional[bool] = Field(default=True, description="partial_results_only")
+    has_join: Optional[bool] = Field(default=True, description="has_join")
+    disable_eu_prospecting: Optional[bool] = Field(default=True, description="disable_eu_prospecting")
+    partial_results_limit: Optional[int] = Field(default=0, description="partial_results_limit")
+    pagination: Optional[Pagination] = Field(default=None, description="pagination")
+    accounts: Optional[List[Any]] = Field(default=None, description="accounts")
+    organizations: Optional[List[Organization]] = Field(default=None, description="organizations")
+    model_ids: Optional[List[str]] = Field(default=None, description="model_ids")
+    num_fetch_result: Optional[str] = Field(default=None, description="num_fetch_result")
+    derived_params: Optional[str] = Field(default=None, description="derived_params")

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/apollo/people.py

@@ -0,0 +1,194 @@
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel, Field
+
+class PeopleEnrichmentQuery(BaseModel):
+    first_name: Optional[str] = Field(default=None, description="The first name of the person. This is typically used in combination with the `last_name` parameter. Example: `tim`")
+    last_name: Optional[str] = Field(default=None, description="The last name of the person. This is typically used in combination with the `first_name` parameter. Example: `zheng`")
+    name: Optional[str] = Field(default=None, description="The full name of the person. This will typically be a first name and last name separated by a space. If you use this parameter, you do not need to use the `first_name` and `last_name` parameters. Example: `tim zheng`")
+    email: Optional[str] = Field(default=None, description="The email address of the person. Example: `example@email.com`")
+    hashed_email: Optional[str] = Field(default=None, description="The hashed email of the person. The email should adhere to either the MD5 or SHA-256 hash format. Example: `8d935115b9ff4489f2d1f9249503cadf` (MD5) or `97817c0c49994eb500ad0a5e7e2d8aed51977b26424d508f66e4e8887746a152` (SHA-256)")
+    organization_name: Optional[str] = Field(default=None, description="The name of the person's employer. This can be the current employer or a previous employer. Example: `apollo`")
+    domain: Optional[str] = Field(default=None, description="The domain name for the person's employer. This can be the current employer or a previous employer. Do not include `www.`, the `@` symbol, or similar. Example: `apollo.io` or `microsoft.com`")
+    id: Optional[str] = Field(default=None, description="The Apollo ID for the person. Each person in the Apollo database is assigned a unique ID. To find IDs, call the [People Search endpoint](/reference/people-search) and identify the values for `person_id`. Example: `587cf802f65125cad923a266`")
+    linkedin_url: Optional[str] = Field(default=None, description="The URL for the person's LinkedIn profile. Example: `http://www.linkedin.com/in/tim-zheng-677ba010`")
+    reveal_personal_emails: Optional[bool] = Field(default=False, description="Set to `true` if you want to enrich the person's data with personal emails. This potentially consumes credits as part of your [Apollo pricing plan](/docs/api-pricing). The default value is `false`. If a person resides in a [GDPR](https://knowledge.apollo.io/hc/en-us/articles/4409141087757)-compliant region, Apollo will not reveal their personal email.")
+    reveal_phone_number: Optional[bool] = Field(default=False, description="Set to `true` if you want to enrich the person's data with all available phone numbers, including mobile phone numbers. This potentially consumes credits as part of your [Apollo pricing plan](/docs/api-pricing). The default value is `false`. If this parameter is set to `true`, you must enter a webhook URL for the `webhook_url` parameter. Apollo will asynchronously verify phone numbers for you, then send a JSON response that includes only details about the person's phone numbers to the webhook URL you provide. It can take several minutes for the phone numbers to be delivered.")
+    webhook_url: Optional[str] = Field(default=None, description="If you set the `reveal_phone_number` parameter to `true`, this parameter becomes mandatory. Otherwise, do not use this parameter. Enter the webhook URL that specifies where Apollo should send a JSON response that includes the phone number you requested. Apollo suggests testing this flow to ensure you receive the separate response with the phone number. Example: `https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40`")
+
+class EmploymentHistory(BaseModel):
+    id: str = Field(description="id")
+    created_at: Optional[str] = Field(default=None, description="created_at")
+    current: bool = Field(default=True, description="current")
+    degree: Optional[str] = Field(default=None, description="degree")
+    description: Optional[str] = Field(default=None, description="description")
+    emails: Optional[str] = Field(default=None, description="emails")
+    end_date: Optional[str] = Field(default=None, description="end_date")
+    grade_level: Optional[str] = Field(default=None, description="grade_level")
+    kind: Optional[str] = Field(default=None, description="kind")
+    major: Optional[str] = Field(default=None, description="major")
+    organization_id: Optional[str] = Field(default=None, description="organization_id")
+    organization_name: str = Field(description="organization_name")
+    raw_address: Optional[str] = Field(default=None, description="raw_address")
+    start_date: str = Field(description="start_date")
+    title: str = Field(description="title")
+    updated_at: Optional[str] = Field(default=None, description="updated_at")
+    id: str = Field(description="id")
+    key: str = Field(description="key")
+    state: Optional[str] = Field(default=None, description="state")
+    city: Optional[str] = Field(default=None, description="city")
+    country: Optional[str] = Field(default=None, description="country")
+    contact_id: Optional[str] = Field(default=None, description="contact_id")
+
+class Contact(BaseModel):
+    contact_roles: List[Any] = Field(description="contact_roles")
+    id: str = Field(description="id")
+    first_name: str = Field(description="first_name")
+    last_name: str = Field(description="last_name")
+    name: str = Field(description="name")
+    linkedin_url: str = Field(description="linkedin_url")
+    title: str = Field(description="title")
+    contact_stage_id: str = Field(description="contact_stage_id")
+    owner_id: Optional[str] = Field(default=None, description="owner_id")
+    creator_id: str = Field(description="creator_id")
+    person_id: str = Field(description="person_id")
+    email_needs_tickling: Optional[bool] = Field(default=None, description="email_needs_tickling")
+    organization_name: str = Field(description="organization_name")
+    source: str = Field(description="source")
+    original_source: str = Field(description="original_source")
+    organization_id: str = Field(description="organization_id")
+    headline: str = Field(description="headline")
+    photo_url: Optional[str] = Field(default=None, description="photo_url")
+    present_raw_address: str = Field(description="present_raw_address")
+    linkedin_uid: Optional[str] = Field(default=None, description="linkedin_uid")
+    extrapolated_email_confidence: Optional[str] = Field(default=None, description="extrapolated_email_confidence")
+    salesforce_id: Optional[str] = Field(default=None, description="salesforce_id")
+    salesforce_lead_id: Optional[str] = Field(default=None, description="salesforce_lead_id")
+    salesforce_contact_id: Optional[str] = Field(default=None, description="salesforce_contact_id")
+    salesforce_account_id: Optional[str] = Field(default=None, description="salesforce_account_id")
+    crm_owner_id: Optional[str] = Field(default=None, description="crm_owner_id")
+    created_at: str = Field(description="created_at")
+    emailer_campaign_ids: List[Any] = Field(description="emailer_campaign_ids")
+    direct_dial_status: Optional[str] = Field(default=None, description="direct_dial_status")
+    direct_dial_enrichment_failed_at: Optional[str] = Field(default=None, description="direct_dial_enrichment_failed_at")
+    email_status: str = Field(description="email_status")
+    email_source: Optional[str] = Field(default=None, description="email_source")
+    account_id: str = Field(description="account_id")
+    last_activity_date: Optional[str] = Field(default=None, description="last_activity_date")
+    hubspot_vid: Optional[str] = Field(default=None, description="hubspot_vid")
+    hubspot_company_id: Optional[str] = Field(default=None, description="hubspot_company_id")
+    crm_id: Optional[str] = Field(default=None, description="crm_id")
+    sanitized_phone: str = Field(description="sanitized_phone")
+    merged_crm_ids: Optional[str] = Field(default=None, description="merged_crm_ids")
+    updated_at: str = Field(description="updated_at")
+    queued_for_crm_push: Optional[str] = Field(default=None, description="queued_for_crm_push")
+    suggested_from_rule_engine_config_id: Optional[str] = Field(default=None, description="suggested_from_rule_engine_config_id")
+    email_unsubscribed: Optional[bool] = Field(default=None, description="email_unsubscribed")
+    label_ids: List[Any] = Field(description="label_ids")
+    has_pending_email_arcgate_request: bool = Field(description="has_pending_email_arcgate_request")
+    has_email_arcgate_request: bool = Field(description="has_email_arcgate_request")
+    existence_level: str = Field(description="existence_level")
+    email: str = Field(description="email")
+    email_from_customer: bool = Field(description="email_from_customer")
+    typed_custom_fields: Dict[str, Any] = Field(description="typed_custom_fields")
+    custom_field_errors: Optional[str] = Field(default=None, description="custom_field_errors")
+    crm_record_url: Optional[str] = Field(default=None, description="crm_record_url")
+    email_status_unavailable_reason: Optional[str] = Field(default=None, description="email_status_unavailable_reason")
+    email_true_status: str = Field(description="email_true_status")
+    updated_email_true_status: bool = Field(description="updated_email_true_status")
+    contact_rule_config_statuses: List[Any] = Field(description="contact_rule_config_statuses")
+    source_display_name: str = Field(description="source_display_name")
+    contact_emails: List[Dict[str, Any]] = Field(description="contact_emails")
+    time_zone: str = Field(description="time_zone")
+    phone_numbers: List[Dict[str, Any]] = Field(description="phone_numbers")
+    account_phone_note: Optional[str] = Field(default=None, description="account_phone_note")
+    free_domain: bool = Field(description="free_domain")
+    is_likely_to_engage: bool = Field(description="is_likely_to_engage")
+
+class Organization(BaseModel):
+    id: str = Field(description="id")
+    name: str = Field(description="name")
+    website_url: str = Field(description="website_url")
+    blog_url: Optional[str] = Field(default=None, description="blog_url")
+    angellist_url: Optional[str] = Field(default=None, description="angellist_url")
+    linkedin_url: str = Field(description="linkedin_url")
+    twitter_url: str = Field(description="twitter_url")
+    facebook_url: str = Field(description="facebook_url")
+    primary_phone: Dict[str, Any] = Field(description="primary_phone")
+    languages: List[Any] = Field(description="languages")
+    alexa_ranking: int = Field(description="alexa_ranking")
+    phone: Optional[str] = Field(default=None, description="phone")
+    linkedin_uid: str = Field(description="linkedin_uid")
+    founded_year: int = Field(description="founded_year")
+    publicly_traded_symbol: Optional[str] = Field(default=None, description="publicly_traded_symbol")
+    publicly_traded_exchange: Optional[str] = Field(default=None, description="publicly_traded_exchange")
+    logo_url: str = Field(description="logo_url")
+    crunchbase_url: Optional[str] = Field(default=None, description="crunchbase_url")
+    primary_domain: str = Field(description="primary_domain")
+    industry: str = Field(description="industry")
+    keywords: List[str] = Field(description="keywords")
+    estimated_num_employees: int = Field(description="estimated_num_employees")
+    industries: List[str] = Field(description="industries")
+    secondary_industries: List[Any] = Field(description="secondary_industries")
+    snippets_loaded: bool = Field(description="snippets_loaded")
+    industry_tag_id: str = Field(description="industry_tag_id")
+    industry_tag_hash: Dict[str, str] = Field(description="industry_tag_hash")
+    retail_location_count: int = Field(description="retail_location_count")
+    raw_address: str = Field(description="raw_address")
+    street_address: str = Field(description="street_address")
+    city: str = Field(description="city")
+    state: str = Field(description="state")
+    postal_code: str = Field(description="postal_code")
+    country: str = Field(description="country")
+    owned_by_organization_id: Optional[str] = Field(default=None, description="owned_by_organization_id")
+    seo_description: str = Field(description="seo_description")
+    short_description: str = Field(description="short_description")
+    suborganizations: List[Any] = Field(description="suborganizations")
+    num_suborganizations: int = Field(description="num_suborganizations")
+    annual_revenue_printed: str = Field(description="annual_revenue_printed")
+    annual_revenue: int = Field(description="annual_revenue")
+    total_funding: int = Field(description="total_funding")
+    total_funding_printed: str = Field(description="total_funding_printed")
+    latest_funding_round_date: str = Field(description="latest_funding_round_date")
+    latest_funding_stage: str = Field(description="latest_funding_stage")
+    funding_events: List[Dict[str, Any]] = Field(description="funding_events")
+    technology_names: List[str] = Field(description="technology_names")
+    current_technologies: List[Dict[str, Any]] = Field(description="current_technologies")
+    org_chart_root_people_ids: List[str] = Field(description="org_chart_root_people_ids")
+    org_chart_sector: str = Field(description="org_chart_sector")
+    org_chart_removed: bool = Field(description="org_chart_removed")
+    org_chart_show_department_filter: bool = Field(description="org_chart_show_department_filter")
+
+class PeopleEnrichmentResponse(BaseModel):
+    person: Optional["Person"] = None
+
+class Person(BaseModel):
+    id: str = Field(description="id")
+    first_name: str = Field(description="first_name")
+    last_name: str = Field(description="last_name")
+    name: str = Field(description="name")
+    linkedin_url: Optional[str] = Field(default=None, description="linkedin_url")
+    title: Optional[str] = Field(default=None, description="title")
+    email_status: Optional[str] = Field(default=None, description="email_status")
+    photo_url: Optional[str] = Field(default=None, description="photo_url")
+    twitter_url: Optional[str] = Field(default=None, description="twitter_url")
+    github_url: Optional[str] = Field(default=None, description="github_url")
+    facebook_url: Optional[str] = Field(default=None, description="facebook_url")
+    extrapolated_email_confidence: Optional[str] = Field(default=None, description="extrapolated_email_confidence")
+    headline: Optional[str] = Field(description="headline")
+    email: Optional[str] = Field(description="email")
+    organization_id: Optional[str] = Field(description="organization_id")
+    employment_history: List[EmploymentHistory] = Field(description="employment_history")
+    state: Optional[str] = Field(default=None, description="state")
+    city: Optional[str] = Field(default=None, description="city")
+    country: Optional[str] = Field(default=None, description="country")
+    contact_id: Optional[str] = Field(default=None, description="contact_id")
+    contact: Optional[Contact] = Field(default=None, description="contact")
+    revealed_for_current_team: bool = Field(description="revealed_for_current_team")
+    organization: Optional[Organization] = Field(default=None, description="organization")
+    is_likely_to_engage: Optional[bool] = Field(default=None, description="is_likely_to_engage")
+    intent_strength: Optional[str] = Field(default=None, description="intent_strength")
+    show_intent: bool = Field(description="show_intent")
+    departments: List[str] = Field(description="departments")
+    subdepartments: List[str] = Field(description="subdepartments")
+    functions: List[str] = Field(description="functions")
+    seniority: Optional[str] = Field(description="seniority")

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/apollo/people_search.py

@@ -0,0 +1,233 @@
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel, Field
+
+class PeopleSearchQuery(BaseModel):
+    person_titles: Optional[List[str]] = Field(default=None, description="Job titles held by the people you want to find. For a person to be included in search results, they only need to match 1 of the job titles you add. Adding more job titles expands your search results. Results also include job titles with the same terms, even if they are not exact matches. For example, searching for `marketing manager` might return people with the job title `content marketing manager`. Use this parameter in combination with the `person_seniorities[]` parameter to find people based on specific job functions and seniority levels. Examples: `sales development representative`; `marketing manager`; `research analyst`")
+    include_similar_titles: Optional[bool] = Field(default=True, description="This parameter determines whether people with job titles similar to the titles you define in the `person_titles[]` parameter are returned in the response. Set this parameter to `false` when using `person_titles[]` to return only strict matches for job titles.")
+    person_locations: Optional[List[str]] = Field(default=None, description="The location where people live. You can search across cities, US states, and countries. To find people based on the headquarters locations of their current employer, use the `organization_locations` parameter. Examples: `california`; `ireland`; `chicago`")
+    person_seniorities: Optional[List[str]] = Field(default=None, description="The job seniority that people hold within their current employer. This enables you to find people that currently hold positions at certain reporting levels, such as Director level or senior IC level. For a person to be included in search results, they only need to match 1 of the seniorities you add. Adding more seniorities expands your search results. Searches only return results based on their current job title, so searching for Director-level employees only returns people that currently hold a Director-level title. If someone was previously a Director, but is currently a VP, they would not be included in your search results. Use this parameter in combination with the `person_titles[]` parameter to find people based on specific job functions and seniority levels. The following options can be used for this parameter: `owner`, `founder`, `c_suite`, `partner`, `vp`, `head`, `director`, `manager`, `senior`, `entry`, `intern`")
+    organization_locations: Optional[List[str]] = Field(default=None, description="The location of the company headquarters for a person's current employer. You can search across cities, US states, and countries. If a company has several office locations, results are still based on the headquarters location. For example, if you search `chicago` but a company's HQ location is in `boston`, people that work for the Boston-based company will not appear in your results, even if they match other parameters. To find people based on their personal location, use the `person_locations` parameter. Examples: `texas`; `tokyo`; `spain`")
+    q_organization_domains_list: Optional[List[str]] = Field(default=None, description="The domain name for the person's employer. This can be the current employer or a previous employer. Do not include `www.`, the `@` symbol, or similar. This parameter accepts up to 1,000 domains in a single request. Examples: `apollo.io`; `microsoft.com`")
+    contact_email_status: Optional[List[str]] = Field(default=None, description="The email statuses for the people you want to find. You can add multiple statuses to expand your search. The statuses you can search include: `verified`, `unverified`, `likely to engage`, `unavailable`")
+    organization_ids: Optional[List[str]] = Field(default=None, description="The Apollo IDs for the companies (employers) you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, call the [Organization Search endpoint](/reference/organization-search) and identify the values for `organization_id`. Example: `5e66b6381e05b4008c8331b8`")
+    organization_num_employees_ranges: Optional[List[str]] = Field(default=None, description="The number range of employees working for the person's current company. This enables you to find people based on the headcount of their employer. You can add multiple ranges to expand your search results. Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. Examples: `1,10`; `250,500`; `10000,20000`")
+    q_keywords: Optional[str] = Field(default=None, description="A string of words over which we want to filter the results.")
+    page: Optional[int] = Field(default=None, description="The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the `per_page` parameter to make search results for navigable and improve the performance of the endpoint. Example: `4`")
+    per_page: Optional[int] = Field(default=None, description="The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance. Use the `page` parameter to search the different pages of data. Example: `10`")
+
+class Breadcrumb(BaseModel):
+    label: str = Field(description="label")
+    signal_field_name: str = Field(description="signal_field_name")
+    value: str = Field(description="value")
+    display_name: str = Field(description="display_name")
+
+class DialerFlags(BaseModel):
+    country_name: str = Field(description="country_name")
+    country_enabled: bool = Field(description="country_enabled")
+    high_risk_calling_enabled: bool = Field(description="high_risk_calling_enabled")
+    potential_high_risk_number: bool = Field(description="potential_high_risk_number")
+
+class PhoneNumber(BaseModel):
+    raw_number: str = Field(description="raw_number")
+    sanitized_number: str = Field(description="sanitized_number")
+    type: str = Field(description="type")
+    position: int = Field(description="position")
+    status: str = Field(description="status")
+    dnc_status: str = Field(description="dnc_status")
+    dnc_other_info: str = Field(description="dnc_other_info")
+    dialer_flags: DialerFlags = Field(description="dialer_flags")
+
+class ContactEmail(BaseModel):
+    email: str = Field(description="email")
+    email_md5: str = Field(description="email_md5")
+    email_sha256: str = Field(description="email_sha256")
+    email_status: str = Field(description="email_status")
+    email_source: str = Field(description="email_source")
+    extrapolated_email_confidence: str = Field(description="extrapolated_email_confidence")
+    position: int = Field(description="position")
+    email_from_customer: str = Field(description="email_from_customer")
+    free_domain: bool = Field(description="free_domain")
+
+class Account(BaseModel):
+    id: str = Field(description="id")
+    name: str = Field(description="name")
+    website_url: str = Field(description="website_url")
+    blog_url: str = Field(description="blog_url")
+    angellist_url: str = Field(description="angellist_url")
+    linkedin_url: str = Field(description="linkedin_url")
+    twitter_url: str = Field(description="twitter_url")
+    facebook_url: str = Field(description="facebook_url")
+    primary_phone: Dict[str, Any] = Field(description="primary_phone")
+    languages: List[Any] = Field(description="languages")
+    alexa_ranking: int = Field(description="alexa_ranking")
+    phone: str = Field(description="phone")
+    linkedin_uid: str = Field(description="linkedin_uid")
+    founded_year: int = Field(description="founded_year")
+    publicly_traded_symbol: str = Field(description="publicly_traded_symbol")
+    publicly_traded_exchange: str = Field(description="publicly_traded_exchange")
+    logo_url: str = Field(description="logo_url")
+    crunchbase_url: str = Field(description="crunchbase_url")
+    primary_domain: str = Field(description="primary_domain")
+    domain: str = Field(description="domain")
+    team_id: str = Field(description="team_id")
+    organization_id: str = Field(description="organization_id")
+    account_stage_id: str = Field(description="account_stage_id")
+    source: str = Field(description="source")
+    original_source: str = Field(description="original_source")
+    creator_id: str = Field(description="creator_id")
+    owner_id: str = Field(description="owner_id")
+    created_at: str = Field(description="created_at")
+    phone_status: str = Field(description="phone_status")
+    hubspot_id: str = Field(description="hubspot_id")
+    salesforce_id: str = Field(description="salesforce_id")
+    crm_owner_id: str = Field(description="crm_owner_id")
+    parent_account_id: str = Field(description="parent_account_id")
+    sanitized_phone: str = Field(description="sanitized_phone")
+    account_playbook_statuses: List[Any] = Field(description="account_playbook_statuses")
+    account_rule_config_statuses: List[Any] = Field(description="account_rule_config_statuses")
+    existence_level: str = Field(description="existence_level")
+    label_ids: List[str] = Field(description="label_ids")
+    typed_custom_fields: Dict[str, Any] = Field(description="typed_custom_fields")
+    custom_field_errors: Dict[str, Any] = Field(description="custom_field_errors")
+    modality: str = Field(description="modality")
+    source_display_name: str = Field(description="source_display_name")
+    salesforce_record_url: str = Field(description="salesforce_record_url")
+    crm_record_url: str = Field(description="crm_record_url")
+
+class EmploymentHistory(BaseModel):
+    id: str = Field(description="id")
+    created_at: str = Field(description="created_at")
+    current: bool = Field(description="current")
+    degree: str = Field(description="degree")
+    description: str = Field(description="description")
+    emails: str = Field(description="emails")
+    end_date: str = Field(description="end_date")
+    grade_level: str = Field(description="grade_level")
+    kind: str = Field(description="kind")
+    major: str = Field(description="major")
+    organization_id: str = Field(description="organization_id")
+    organization_name: str = Field(description="organization_name")
+    raw_address: str = Field(description="raw_address")
+    start_date: str = Field(description="start_date")
+    title: str = Field(description="title")
+    updated_at: str = Field(description="updated_at")
+    id: str = Field(description="id")
+    key: str = Field(description="key")
+
+class Organization(BaseModel):
+    id: str = Field(description="id")
+    name: str = Field(description="name")
+    website_url: str = Field(description="website_url")
+    blog_url: str = Field(description="blog_url")
+    angellist_url: str = Field(description="angellist_url")
+    linkedin_url: str = Field(description="linkedin_url")
+    twitter_url: str = Field(description="twitter_url")
+    facebook_url: str = Field(description="facebook_url")
+    primary_phone: Dict[str, Any] = Field(description="primary_phone")
+    languages: List[Any] = Field(description="languages")
+    alexa_ranking: int = Field(description="alexa_ranking")
+    phone: str = Field(description="phone")
+    linkedin_uid: str = Field(description="linkedin_uid")
+    founded_year: int = Field(description="founded_year")
+    publicly_traded_symbol: str = Field(description="publicly_traded_symbol")
+    publicly_traded_exchange: str = Field(description="publicly_traded_exchange")
+    logo_url: str = Field(description="logo_url")
+    crunchbase_url: str = Field(description="crunchbase_url")
+    primary_domain: str = Field(description="primary_domain")
+
+class Contact(BaseModel):
+    contact_roles: List[Any] = Field(description="contact_roles")
+    id: str = Field(description="id")
+    first_name: str = Field(description="first_name")
+    last_name: str = Field(description="last_name")
+    name: str = Field(description="name")
+    linkedin_url: str = Field(description="linkedin_url")
+    title: str = Field(description="title")
+    contact_stage_id: str = Field(description="contact_stage_id")
+    owner_id: str = Field(description="owner_id")
+    creator_id: str = Field(description="creator_id")
+    person_id: str = Field(description="person_id")
+    email_needs_tickling: bool = Field(description="email_needs_tickling")
+    organization_name: str = Field(description="organization_name")
+    source: str = Field(description="source")
+    original_source: str = Field(description="original_source")
+    organization_id: str = Field(description="organization_id")
+    headline: str = Field(description="headline")
+    photo_url: str = Field(description="photo_url")
+    present_raw_address: str = Field(description="present_raw_address")
+    linkedin_uid: str = Field(description="linkedin_uid")
+    extrapolated_email_confidence: str = Field(description="extrapolated_email_confidence")
+    salesforce_id: str = Field(description="salesforce_id")
+    salesforce_lead_id: str = Field(description="salesforce_lead_id")
+    salesforce_contact_id: str = Field(description="salesforce_contact_id")
+    salesforce_account_id: str = Field(description="salesforce_account_id")
+    crm_owner_id: str = Field(description="crm_owner_id")
+    created_at: str = Field(description="created_at")
+    emailer_campaign_ids: List[str] = Field(description="emailer_campaign_ids")
+    direct_dial_status: str = Field(description="direct_dial_status")
+    direct_dial_enrichment_failed_at: str = Field(description="direct_dial_enrichment_failed_at")
+    email_status: str = Field(description="email_status")
+    email_source: str = Field(description="email_source")
+    account_id: str = Field(description="account_id")
+    last_activity_date: str = Field(description="last_activity_date")
+    hubspot_vid: str = Field(description="hubspot_vid")
+    hubspot_company_id: str = Field(description="hubspot_company_id")
+    crm_id: str = Field(description="crm_id")
+    sanitized_phone: str = Field(description="sanitized_phone")
+    merged_crm_ids: str = Field(description="merged_crm_ids")
+    updated_at: str = Field(description="updated_at")
+    queued_for_crm_push: bool = Field(description="queued_for_crm_push")
+    suggested_from_rule_engine_config_id: str = Field(description="suggested_from_rule_engine_config_id")
+    email_unsubscribed: str = Field(description="email_unsubscribed")
+    label_ids: List[Any] = Field(description="label_ids")
+    has_pending_email_arcgate_request: bool = Field(description="has_pending_email_arcgate_request")
+    has_email_arcgate_request: bool = Field(description="has_email_arcgate_request")
+    existence_level: str = Field(description="existence_level")
+    email: str = Field(description="email")
+    email_from_customer: str = Field(description="email_from_customer")
+    typed_custom_fields: Dict[str, Any] = Field(description="typed_custom_fields")
+    custom_field_errors: Dict[str, Any] = Field(description="custom_field_errors")
+    salesforce_record_url: str = Field(description="salesforce_record_url")
+    crm_record_url: str = Field(description="crm_record_url")
+    email_status_unavailable_reason: str = Field(description="email_status_unavailable_reason")
+    email_true_status: str = Field(description="email_true_status")
+    updated_email_true_status: bool = Field(description="updated_email_true_status")
+    contact_rule_config_statuses: List[Dict[str, Any]] = Field(description="contact_rule_config_statuses")
+    source_display_name: str = Field(description="source_display_name")
+    twitter_url: str = Field(description="twitter_url")
+    contact_campaign_statuses: List[Dict[str, Any]] = Field(description="contact_campaign_statuses")
+    state: str = Field(description="state")
+    city: str = Field(description="city")
+    country: str = Field(description="country")
+    account: Account = Field(description="account")
+    contact_emails: List[ContactEmail] = Field(description="contact_emails")
+    organization: Organization = Field(description="organization")
+    employment_history: List[EmploymentHistory] = Field(description="employment_history")
+    time_zone: str = Field(description="time_zone")
+    intent_strength: str = Field(description="intent_strength")
+    show_intent: bool = Field(description="show_intent")
+    phone_numbers: List[PhoneNumber] = Field(description="phone_numbers")
+    account_phone_note: str = Field(description="account_phone_note")
+    free_domain: bool = Field(description="free_domain")
+    is_likely_to_engage: bool = Field(description="is_likely_to_engage")
+    email_domain_catchall: bool = Field(description="email_domain_catchall")
+    contact_job_change_event: str = Field(description="contact_job_change_event")
+
+class Pagination(BaseModel):
+    page: int = Field(description="page")
+    per_page: int = Field(description="per_page")
+    total_entries: int = Field(description="total_entries")
+    total_pages: int = Field(description="total_pages")
+
+class PeopleSearchResponse(BaseModel):
+    # breadcrumbs: Optional[List[Breadcrumb]] = Field(default=None, description="breadcrumbs")
+    partial_results_only: Optional[bool] = Field(default=None, description="partial_results_only")
+    has_join: Optional[bool] = Field(default=None, description="has_join")
+    disable_eu_prospecting: Optional[bool] = Field(default=None, description="disable_eu_prospecting")
+    partial_results_limit: Optional[int] = Field(default=None, description="partial_results_limit")
+    pagination: Optional[Pagination] = Field(default=None, description="pagination")
+    contacts: Optional[List[Contact]] = Field(default=None, description="contacts")
+    people: Optional[List[Any]] = Field(default=None, description="people")
+    model_ids: Optional[List[str]] = Field(default=None, description="model_ids")
+    num_fetch_result: Optional[str] = Field(default=None, description="num_fetch_result")
+    # derived_params: Optional[str] = Field(default=None, description="derived_params")

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_edwardchoh-apollo-io-mcp-server
+Version: 0.1.0
+Summary: MCP server that exposes the Apollo.io API functionalities as tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: python-dotenv
+Requires-Dist: httpx
+Dynamic: license-file
+
+# Apollo.io MCP Server
+
+This project provides an MCP server that exposes the Apollo.io API functionalities as tools. It allows you to interact with the Apollo.io API using the Model Context Protocol (MCP).
+
+## Overview
+
+The project consists of the following main components:
+
+- `apollo_client.py`: Defines the `ApolloClient` class, which is used to interact with the Apollo.io API. It includes methods for people enrichment, organization enrichment, people search, organization search, and organization job postings.
+- `server.py`: Defines the FastMCP server, which exposes the Apollo.io API functionalities as tools. It uses the `ApolloClient` class defined in `apollo_client.py` to interact with the API.
+- `apollo/`: Contains the data models for the Apollo.io API, such as `PeopleEnrichmentQuery`, `OrganizationEnrichmentQuery`, `PeopleSearchQuery`, `OrganizationSearchQuery`, and `OrganizationJobPostingsQuery`.
+
+## Functionalities
+
+The following functionalities are exposed as MCP tools:
+
+-   `people_enrichment`: Use the People Enrichment endpoint to enrich data for 1 person.
+-   `organization_enrichment`: Use the Organization Enrichment endpoint to enrich data for 1 company.
+-   `people_search`: Use the People Search endpoint to find people.
+-   `organization_search`: Use the Organization Search endpoint to find organizations.
+-   `organization_job_postings`: Use the Organization Job Postings endpoint to find job postings for a specific organization.
+
+## Usage
+
+To use this MCP server, you need to:
+
+1. Set the `APOLLO_IO_API_KEY` environment variable with your Apollo.io API key. Or create '.env' file in the project root with `APOLLO_IO_API_KEY`.
+2. Get dependencies: `uv sync`
+3. Run the `uv run mcp run server.py`
+
+## Data Models
+
+The `apollo/` directory contains the data models for the Apollo.io API. These models are used to define the input and output of the MCP tools.
+
+- `apollo/people.py`: Defines the data models for the People Enrichment endpoint.
+- `apollo/organization.py`: Defines the data models for the Organization Enrichment endpoint.
+- `apollo/people_search.py`: Defines the data models for the People Search endpoint.
+- `apollo/organization_search.py`: Defines the data models for the Organization Search endpoint.
+- `apollo/organization_job_postings.py`: Defines the data models for the Organization Job Postings endpoint.
+
+## Testing
+
+To test, set `APOLLO_IO_API_KEY` environment variable and run `uv run apollo_client.py`.
+
+## Usage with Claude for Desktop
+
+1. Configure Claude for Desktop to use these MCP servers by adding them to your `claude_desktop_config.json` file:
+
+```json
+{
+  "mcpServers": {
+    "apollo-io-mcp-server": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "run",
+        "mcp",
+        "run",
+        "path/to/apollo-io-mcp-server/server.py"
+      ]
+    }
+  }
+}
+```
+
+## Resources
+
+- [Apollo.io API Documentation](https://docs.apollo.io/reference/)
+- [MCP Protocol Documentation](https://github.com/modelcontextprotocol/mcp)
+- [Claude for Desktop Documentation](https://claude.ai/docs)

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+apollo/__init__.py
+apollo/organization.py
+apollo/organization_job_postings.py
+apollo/organization_search.py
+apollo/people.py
+apollo/people_search.py
+iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/PKG-INFO
+iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/SOURCES.txt
+iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/dependency_links.txt
+iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/entry_points.txt
+iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/requires.txt
+iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/top_level.txt

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+apollo-io-mcp = server:main

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/requires.txt

@@ -0,0 +1,3 @@
+mcp[cli]>=1.6.0
+python-dotenv
+httpx

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/iflow_mcp_edwardchoh_apollo_io_mcp_server.egg-info/top_level.txt

@@ -0,0 +1 @@
+apollo

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "iflow-mcp_edwardchoh-apollo-io-mcp-server"
+version = "0.1.0"
+description = "MCP server that exposes the Apollo.io API functionalities as tools"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp[cli]>=1.6.0",
+    "python-dotenv",
+    "httpx",
+]
+
+[project.scripts]
+apollo-io-mcp = "server:main"

iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+