Village MCP server

Get App Information

Get information about the partner application associated with your token — title, description, domain, logo URL, public key, and active flag. Useful for verifying your app configuration.

Check Company Paths

Quickly check if you have connections to a company without fetching full details. Returns whether paths exist, an overall score, count of reachable people, and avatar thumbnails.

3 fields

Refresh Companies

Refresh/import company data from LinkedIn URLs or domains. Realtime mode returns enriched data synchronously (or times out after 25s); async mode returns job IDs for later status checking. At least one of linkedin_urls or domains must be provided.

4 fields

Enrich Company

Get detailed information about a company by domain, LinkedIn URL, or any URL. Returns name, website, LinkedIn URL, logo, employee count, industry, founded year, and description.

3 fields

Enrich Company (Bulk)

Get detailed information for up to 10 companies in a single request. Each result contains either company data or an error.

1 field

Get Company Paths

Find introduction paths to people at a specific company. Returns up to 50 employees you can reach through your network, ranked by connection strength.

6 fields

List Companies

Get your top-connected companies ranked by network strength. Returns a paginated list with connection score, label, LinkedIn URL, domain, and enrichment data.

3 fields

Search Companies

Search for companies using natural language (in the "prompt" field) and/or structured filters. Returns matching companies with relevance and connection-strength scores; supports cursor-based pagination.

8 fields

Sort Companies

Rank a list of companies (up to 100 LinkedIn URLs or domains) by how well-connected you are to people there. Each result includes a score, label, LinkedIn URL, and domain.

1 field

Join Group

Join a group using an invite link. Once joined, you gain access to the shared network of all group members.

1 field

Leave Group

Leave a group you are a member of. If you are the last member, the group is deleted. Admins must remove all other members before leaving.

1 field

List Groups

Get all groups (communities) you are a member of. Groups allow members to share network access with each other, expanding everyone's reach.

Create or Update Group

Create a new group or update an existing one. To create: provide a name (id is auto-generated). To update: provide group_id (requires admin permissions).

3 fields

List Gmail Integrations

Get all your connected Gmail integrations, including rate limits, timezone, the default sending account, and whether you can add more based on your plan.

Reset Integration

Trigger a full resync of a Google or LinkedIn integration. Clears sync cursors and re-imports all contacts/calendar data; all graph operations use MERGE so it is fully idempotent.

1 field

Update Gmail Integration

Update settings for a connected Gmail integration — adjust rate limits, timezone, status, or set as the default sending account. Provide only the fields you want to change.

7 fields

Add items to list

Add people or companies to a list. Each identifier is resolved (LinkedIn URLs, company domains, emails, or graph IDs) and added. Returns detailed results per item.

2 fields

Check list membership

Check which lists contain the given entities. Returns a map of entity_id to the lists that contain it. Entities not in any list are omitted.

2 fields

Create a list

Create a new list to organize people or companies. The creator becomes the list owner. List creation may be limited based on your subscription plan.

4 fields

Delete a list

Permanently delete a list and all its items. This action cannot be undone.

1 field

Get a list

Get a list with all its items. Returns the list metadata plus paginated items. For people lists, items are sorted by connection strength (warmth score).

3 fields

List all lists

Get all your saved lists of people or companies. Supports pagination, filtering by type, and searching by title.

4 fields

Remove items from list

Remove items from a list by their item IDs (obtained from get_list). Returns the count of successfully removed items.

2 fields

Update a list

Update a list's metadata. Provide at least one of: title or description. The list type cannot be changed after creation.

3 fields

Enrich Person

Get detailed profile information (name, headline, current company, location, photo, LinkedIn URL) for a person identified by LinkedIn URL or generic URL.

2 fields

Enrich Person (Bulk)

Get detailed profile information for up to 10 people in a single request. Partial results are returned if some lookups fail — check each result for success or error status.

1 field

Enrich Person Email

Find the email address for a person by LinkedIn URL or generic URL. Returns the verified email address if found, or null if unavailable.

2 fields

Enrich Person Email (Bulk)

Find email addresses for up to 10 people in a single request. Returns email addresses where found, with error messages for failed lookups.

1 field

Get Person Paths

Find introduction paths to reach a specific person through your professional network. Provide a LinkedIn URL and get back direct connections, mutual contacts, and connection strength scores (0-100).

2 fields

Get Person Paths (Bulk)

Find introduction paths to multiple people in a single request. Provide up to 100 LinkedIn IDs (the slug after linkedin.com/in/) and get connection paths for each.

1 field

List People

Get your network contacts ranked by connection strength. Returns a paginated list with enrichment data, supporting cursor-based pagination and optional connection-degree filtering.

4 fields

Refresh People

Refresh or import people data from LinkedIn URLs. In realtime mode, returns enriched person data immediately (or times out after 25 seconds and converts to async). In async mode, returns job IDs for later status checking.

2 fields

Search People

Search for people using natural language queries. Pass your search text in "prompt" (e.g. "engineers at Google"). Supports cursor-based pagination and structured filters.

9 fields

Sort People

Rank a list of LinkedIn profile URLs by how well-connected you are to them. Returns each person sorted by connection strength (highest first), with score (0-100) and score_label.

1 field

Join Team

Join a team using an invite link. Provide the invite link code (the part after /join/ in the URL).

1 field

Leave Team

Leave a team you are a member of. If you are the last member of a non-paid team, the team is deleted. Admins of paid teams cannot leave — use Cancel Plan instead.

1 field

List Teams

Get all teams you are a member of. Each team includes id, name, logo, invite_link, and an is_admin flag indicating your admin status.

Create or Update Team

Create or update a team. The team ID is derived from the team name; repeated calls with the same name update the same team (requires admin permissions on update).

2 fields

Get Current User

Get profile information for the authenticated user — id, email, name, account creation date, sync completion status, and active flag. Useful for verifying auth and checking whether the user's network data is ready.

Import Relationships

Import manual relationships to expand your network graph — useful for adding people you know but aren't connected to digitally. Provide email addresses or LinkedIn URLs with optional scores (0-10); higher scores indicate stronger relationships. Max 1000 per request.

2 fields