Integration

Village integration

Village is a relationship-intelligence platform that maps your professional network and finds warm introductions. Find introduction paths to a person or to the people at a company, rank people and companies by connection strength, search people and companies, enrich profiles and find email addresses, manage saved lists, teams, groups and webhooks, and run AI email outreach sequences (leads, drafts, approvals). Many calls spend Village credits (1 credit = $0.02); each tool states its cost. Partner-app user provisioning (tokens minted from an app secret key, user cancellation, app info), the AI project-planner flow, the streaming search mode and moving drafts to another sending mailbox are not exposed. Authentication: a personal Village API token (Village settings, API keys) sent as a Bearer token.

Connect Village How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Village.Built from the 67 Village tools below, on the connection you add once.

What you can do with Village

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

List, 7 operations

check_list_membershipCheck list membershipPOSTTells which of your lists contain the given people or companies: a map from each entity id to the lists holding it (entities in no list are omitted). Free.
create_listCreate listPOSTCreates a list of people or companies (title required; type people or company). Village's docs page lists this call at 5 credits plus per-result and AI charges; the number of lists may be limited by plan.
delete_listDelete listDELETEPermanently deletes one of your lists and all its items. Cannot be undone. Free.
get_listGet listGETReturns a list and its items, warmest first. Pass your numeric list id (owner view, every field) or a published list's public identifier (public view: no paths, contacts or warmth). Free. Page items with pagination.cursor.
list_listsList listsGETLists your saved people and company lists (id, title, type, item_count, publishing state). Free. Filter by type or a title search; include_summary=true adds screening and import state. Page with pagination.cursor.
refresh_listRefresh listPOSTRe-runs a search-created list's saved search in the background and appends new matches (existing items stay); poll get_list until done. add tops it up by a set number. No flat fee, but new rows cost credits (402: none affordable); 429 means wait.
update_listUpdate listPATCHRenames a list, changes its description, opts it into the daily new-search-results email (notifications_enabled) or publishes and unpublishes it (is_public). Send at least one field; others are kept. Free.

Person, 6 operations

enrich_personEnrich personPOSTReturns a person's professional profile (name, headline, title, company, location, photo) from a LinkedIn URL; personal data. Cached profiles are free; a live fetch is charged. mode=cached_only never charges.
enrich_person_bulkEnrich person bulkPOSTReturns professional profiles for up to 10 people by LinkedIn URL in one call, with a per-person result or error; personal data. Cached profiles are free, live fetches are charged; mode=cached_only never charges.
enrich_person_by_emailEnrich person by emailPOSTReverse lookup: finds the person behind an email address. An address Village does not know is sent to Apollo.io and the match saved to Village. 1 credit per person found plus any live profile fetch; mode=cached_only is free.
list_peopleList peoplePOSTLists the people in your Village network ranked by connection strength, with profile data (personal data). Costs 3 credits per 10 results returned. Page with pagination.cursor.
search_peopleSearch peoplePOSTFinds people from a natural-language prompt (put it in prompt) or structured filters; searches your network unless scope=global. Costs 3 credits per 10 results plus 2-3 for the AI. Complex searches take 20-60 s: wait for them.
sort_peopleSort peoplePOSTRanks people (LinkedIn profile URLs) by how well connected you are to each, strongest first, with score and score_label. Costs 5 credits per 10 people ranked.

Sequence, 6 operations

archive_sequenceArchive sequenceDELETEArchives a sequence (its status becomes archived). Free.
change_sequence_outreach_approachChange sequence outreach approachPUTChanges a sequence's strategy (warm_intro, cold_warm_lever or cold) and regenerates its templates: new and waiting leads move onto it and pending drafts are dropped and rewritten. Approved and sent emails are untouched. Free.
create_sequenceCreate sequencePOSTCreates an outreach sequence (an AI email campaign): name, plus either your own ai_email_templates or a use_case with an outreach_approach to start from Village's templates. Costs 5 credits. Sends nothing by itself.
get_sequenceGet sequenceGETReturns one outreach sequence by its encrypted id: status, AI instructions, email templates and statistics. Use it to show the user what will be sent. Free.
list_sequencesList sequencesGETLists your outreach sequences (email campaigns), newest first, with status, templates and send statistics. Filter by status or search; page with pagination.cursor. Free.
update_sequenceUpdate sequencePUTUpdates a sequence: send only the fields to change (name, description, status draft, active, paused or archived, AI instructions, templates, outreach approach). Setting status active resumes drafting and sending. Free.

Team, 6 operations

discover_teams_by_domainDiscover teams by domainGETLists the teams that claimed the domain of your email address (teams you are not in yet), with member count and network reach. Empty for public email providers. Free.
join_teamJoin teamPOSTJoins a team from its invite link code; this shares your network: your contacts become visible to every current and future team member. Returns joined, or pending when an admin must approve. Free.
join_team_by_domainJoin team by domainPOSTJoins the team that claimed your email domain. A free team adds you at once; a paid Core or Business team may add a $1 seat to its plan, otherwise your request waits for admin approval. Shares your network. Free.
leave_teamLeave teamPOSTLeaves a team. If you are the last member of a non-paid team this deletes it with all its lists, projects and sequences: refused with 409 unless delete_workspace=true, sent only after the user agreed. Free.
list_teamsList teamsGETLists the teams (shared workspaces) you belong to, with id, name, logo, invite_link and whether you are admin. Free.
upsert_teamUpsert teamPOSTCreates a team (send name; you become admin) or renames an existing one you administer (send team_id too). Optional logo and email domain for domain-based discovery. Returns the team and its invite_link. Free.

Company, 5 operations

enrich_companyEnrich companyPOSTReturns a company's profile (name, website, LinkedIn URL, logo, headcount, industry, founded year, description) from a domain or URL. Cached data is free; a live fetch is charged. mode=cached_only never charges.
enrich_company_bulkEnrich company bulkPOSTReturns company profiles for up to 10 domains, LinkedIn URLs or URLs in one call, with a per-company result or error. Cached data is free, live fetches are charged; mode=cached_only never charges.
list_companiesList companiesPOSTLists the companies you are best connected to, ranked by network strength (score, score_label, LinkedIn URL, domain). Costs 3 credits per 10 results returned. Page with pagination.cursor.
search_companiesSearch companiesPOSTFinds companies from a natural-language prompt (put it in prompt) or structured filters; searches your network unless scope=global. Costs 3 credits per 10 results plus 2-3 for the AI. Complex searches take 20-60 s: wait.
sort_companiesSort companiesPOSTRanks up to 100 companies (LinkedIn URLs or domains) by how well connected you are to people there, strongest first, with score and score_label. Costs 5 credits per 10 companies ranked.

Sequence activity, 5 operations

create_sequence_activityCreate sequence activityPOSTActs on a sequence lead: add a note (add_note), add a note and replan (add_note_replan), finish, snooze (1_day, 3_days, 1_week) or remove the lead. Free.
get_sequence_outgoing_activitiesGet sequence outgoing activitiesGETLists the email activities across all your sequences (drafts and queued emails) with decision (pending, approved, rejected), AI confidence, lead, person and email. Use it to review drafts. Free.
regenerate_activityRegenerate activityPOSTDeletes a pending drafted email and has the AI redraft it with the sequence's latest instructions and templates. Free.
send_test_emailSend test emailPOSTSends a drafted sequence email to YOUR OWN address (the connected user's, never anyone else) to preview how it renders, optionally with an edited subject and body. Does not affect open or click rates. Free.
update_activity_decisionUpdate activity decisionPATCHApproves, rejects or resets a drafted email, optionally editing it. decision=approved lets Village SEND the email to a real recipient from the connected mailbox: approve only a draft the user has read and accepted. Free.

Sequence lead, 5 operations

add_leads_to_sequenceAdd leads to sequencePOSTEnrolls up to 100 people in a sequence by their Village person ids; Village then drafts emails to them, which wait for approval before anything is sent. Free.
bulk_update_sequence_leadsBulk update sequence leadsPUTSets the same introducers on every lead of a sequence at once (for example when converting a campaign to cold email). Free.
delete_sequence_leadDelete sequence leadDELETERemoves a lead from its sequence (its status becomes deleted). Free.
get_sequence_leadsGet sequence leadsGETLists the people (leads) enrolled in a sequence with their status, introducers and next follow-up (personal data). A lead that replied is finished automatically; reply content is not available here. Free.
update_sequence_leadUpdate sequence leadPUTChanges one lead in a sequence: its status (active, not_started, pending, finished, deleted), its introducers or its next follow-up time. Send only what changes. Free.

Webhook, 5 operations

create_webhookCreate webhookPOSTRegisters a URL that Village POSTs your relationship activity to (connections, job changes, list and sequence events). This sends the user's data to that URL: use only a URL the user gave you. Free.
delete_webhookDelete webhookDELETEPermanently deletes a webhook; deliveries stop at once and the id is gone (to pause instead, use update_webhook with is_active=false). Free.
get_webhookGet webhookGETReturns one webhook by its encrypted id: url, event_filter, is_active and has_secret (the secret itself is never returned). 404 when it does not exist or is not yours. Free.
list_webhooksList webhooksGETLists the webhooks that receive your Village activity: url, event_filter (empty means every event type), is_active and has_secret. Filter by is_active or search url and description; page with pagination.cursor. Free.
update_webhookUpdate webhookPATCHChanges a webhook's url, events, secret or active state (is_active=false pauses it, better than deleting). Send only what changes. event_filter REPLACES the whole list. A new url redirects the user's data: confirm first. Free.

Group, 4 operations

join_groupJoin groupPOSTJoins a group from its invite link code; this shares your network: your contacts become visible to every current and future member. Fails when the invite is invalid or you already belong. Free.
leave_groupLeave groupPOSTLeaves a group. If you are its last member the group is deleted; admins must first remove all other members. Free.
list_groupsList groupsGETLists the groups (communities that pool their members' networks) you belong to, with id, name, logo, invite_link and whether you are admin. Free.
upsert_groupUpsert groupPOSTCreates a group (send name; you become admin) or updates one you administer (send group_id too). Returns the group and its invite_link. Free.

Introduction path, 4 operations

check_company_pathsCheck company pathsPOSTQuickly checks whether you have connections at a company (by domain or LinkedIn URL): has_paths, score, count of reachable people and connector avatars. Costs 1 credit; faster than get_company_paths.
get_company_pathsGet company pathsPOSTFinds the people at a company you can reach through your network (by domain or LinkedIn URL), with their introducers and warmth scores, up to 50 employees per page. Costs 5 credits per call.
get_person_pathsGet person pathsPOSTFinds warm-introduction paths to one person from a LinkedIn URL: direct links, mutual contacts who can introduce you, and warmth scores (Excellent 10+, Very Good 7.5+, Good 4+, Okay 1+). Costs 5 credits per call.
get_person_paths_bulkGet person paths bulkPOSTFinds introduction paths to up to 100 people at once, by LinkedIn identifier (the johndoe part of linkedin.com/in/johndoe). Costs 3 credits per 10 results returned.

List item, 2 operations

add_list_itemsAdd list itemsPOSTAdds up to 100 people or companies to a list by LinkedIn URL, domain, email or Village graph_id; returns a per-item result (created item, duplicate or error). Free.
remove_list_itemsRemove list itemsDELETERemoves up to 100 items from a list by their list-item ids (the items[].id from get_list, not person or company ids). Returns how many were removed. Free.

Person email, 2 operations

enrich_person_emailEnrich person emailPOSTFinds a person's email address from a LinkedIn URL: email (best address, or empty) and emails (all known, best first). May query Apollo.io live. Costs 1 credit per email found, nothing when none is found.
enrich_person_email_bulkEnrich person email bulkPOSTFinds email addresses for up to 10 people by LinkedIn URL, each looked up live at Apollo.io, with a per-person error when none is found. Costs 1 credit per email found.

Relationship, 2 operations

import_relationshipsImport relationshipsPOSTAdds up to 1000 people you know (emails or LinkedIn URLs, optional strength 0-10) to your network graph; returns created, updated and failed counts. Costs 1 credit per relationship imported.
import_relationships_from_listImport relationships from listPOSTQueues a background import of the people in one of your people lists into your network graph (all, a subset, or all but some). Costs 1 credit per relationship imported. Progress shows on the list.

Sequence email, 2 operations

cancel_outgoing_emailCancel outgoing emailDELETECancels one outgoing email of a sequence so it is not sent (its status becomes canceled). Free.
get_sequence_emailsGet sequence emailsGETLists a sequence's outgoing emails (drafted, scheduled, sending, sent, failed, canceled) with subject, body, recipient and send times. Outgoing only: replies stay in the user's mailbox. Free.

Work overlap, 2 operations

get_work_overlap_statsGet work overlap statsGETReturns headline counts for work overlaps: people you overlapped with directly and people your first-degree connections overlapped with. Free.
list_work_overlapsList work overlapsGETLists people you (scope=own, default) or your first-degree connections (scope=network) worked with at past companies: shared company, overlap window and current role (personal data). Free. Page with pagination.cursor.

Email template, 1 operation

get_system_email_templatesGet system email templatesGETReturns Village's standard outreach email templates, optionally for one use_case (for example sales, recruiting, intro_request), each with its audience (warm, cold_referral, cold). Free.

Linkedin post, 1 operation

get_person_postsGet person postsPOSTReturns a person's recent LinkedIn posts, newest first, including posts they reshared (check author and reposted_by). Costs 1 credit per page of up to 50 posts fetched; follow pagination.cursor for older posts.

User, 1 operation

get_current_userGet current userGETReturns the connected Village account: email, name, creation date and is_sync_complete (whether the network data is ready). Identify the user by email; id and is_active describe partner apps only. Free.

Workspace, 1 operation

switch_workspaceSwitch workspacePATCHSwitches your active Village workspace to a team you belong to. Persistent: it re-scopes every later Village call and the Village web app until switched back. 403 when you are not a member. Free.

Use Village from Claude Code, Cursor or Codex

Connect Village in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Village operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Village

Create your workspace
Sign up free. Nothing to install.
Connect Village once
Add your Village connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.