Ocean.io integration for AI agents.
Ocean.io integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Ocean.io tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.
Real Ocean.io actions, managed and audited.
Your user connects Ocean.io once; your agent can then use the Ocean.io API to search and enrich companies and people, inspect data fields, reveal contact details, and manage segmentations — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.
- 1
Your user grants Ocean.io access once (OAuth) — the token lands in the vault.
- 2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
- 3
Every routed call appends a hash-chained audit record — nothing leaves your infra.
Supported Ocean.io tools.
26 tools are generated from the published Ocean.io catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.
Showing 26 tools. All published catalog entries are included in this page's server-rendered HTML.
- Add domains to the positive or negative list of a segmentation
- Append domains to the positive or negative list of an existing segmentation to steer future results toward good-fit companies and away from poor-fit ones.
- Segmentation
- Attribute domains to segments
- Assign each input domain to the closest segment in a segmentation, with a 0-1 match score. The segmentation must have completed successfully first.
- Segmentation
- Autocomplete companies
- Auto complete the name search
- Autocomplete
- Autocomplete job titles
- Auto complete the job title search.
- Autocomplete
- Autocomplete keywords
- Auto complete the keyword search.
- Autocomplete
- Autocomplete locations
- Auto complete the location search
- Autocomplete
- Autocomplete skills
- Auto complete the skill search.
- Autocomplete
- Create segmentation
- Create a new segmentation from a list of company domains. Runs asynchronously — poll [Get Segmentation](/docs/getSegmentation) until `status` is `SUCCESSFUL` to read the resulting segments.
- Segmentation
- Enrich companies
- Match companies with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_companies)
- Enrich
- Enrich company
- Match a company with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_person_email)
- Enrich
- Enrich people
- Match people with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_people)
- Enrich
- Enrich person
- Match a person with our database and enrich it with additional information. **Webhook result:** [Documentation](/docs/webhooks/enrich_person_phone)
- Enrich
- Get credit balance
- Get credit balance
- Other
- Get data fields
- Provides a list of all industries and industry categories, technologies and regions searchable by Ocean.io. Calling this endpoint does not consume any credits.
- Other
- Get segmentation
- Retrieve a segmentation by its id, including its segments, traits, and CRM metrics once `status` is `SUCCESSFUL`.
- Segmentation
- Lookup multiple companies by domain
- Lookup and enrich multiple companies by domain (max 1000). This endpoint provides simple, per-result pricing. **Key features:** - Batch lookup up to 1000 company domains - Domain redirections are handled automatically Returns enriched company data for each domain. Companies not found will have `company: null` in the result.
- Lookup
- Lookup multiple people by LinkedIn handle or Ocean ID
- Lookup and enrich multiple people by LinkedIn handles and/or Ocean.io IDs (max 1000 total). This endpoint provides simple, per-result pricing. **Key features:** - Batch lookup up to 1000 people (combined total of linkedinHandles + oceanIds) - Provide either linkedinHandles, oceanIds, or both lists Returns only successfully matched people in the response.
- Lookup
- Preview - Lookalike companies
- Preview search companies using filters. **Only available for enterprise API customers.**
- Search
- Reveal emails
- Get emails and email statuses for people. **Webhook result:** [Documentation](/docs/webhooks/reveal_emails)
- Reveal
- Reveal phones
- Get phones and phone statuses for people. **Webhook result:** [Documentation](/docs/webhooks/reveal_phones)
- Reveal
- Lookalike companies search (deprecated)
- Search companies using filters.
- Search
- Lookalike companies search
- Search companies using filters. Looking for the legacy endpoint? [Access it here](/docs/searchCompanies)
- Search
- Search people (deprecated)
- Search people using filters and/or people Ids
- Search
- Lookalike people search
- Search people using filters and/or people Ids Looking for the legacy endpoint? [Access it here](/docs/searchPeople) **Webhook result:** [Email results](/docs/webhooks/people_search_emails) [Phone results](/docs/webhooks/people_search_phones)
- Search
- Preview - Lookalike people
- Preview search people with company information. **Only available for enterprise API customers.**
- Search
- Warmup companies
- Check available companies in Ocean's database and trigger process of data gathering for the missing ones. Calling this endpoint does not consume any credits
- Other
Ocean.io integration, answered
- How do AI agents use Ocean.io through Open Connector?
- Your user connects Ocean.io once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Ocean.io tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
- Is this a Ocean.io MCP server?
- Yes. Open Connector can serve Ocean.io as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Ocean.io actions with credentials injected server-side.
- Where do Ocean.io credentials live?
- In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.
Give your agents Ocean.io — keep the keys.
Open source, self-hostable, with Ocean.io credentials that never leave your infrastructure. Run it from source today.