Skip to documentation

Connect your AI tools to Vsyble

Vsyble's hosted MCP server gives compatible AI clients access to people search, company search, enrichment, and outreach. The remote connection uses browser OAuth, so you do not need to install a package or copy an API key.

Server URL

https://mcp.vsyble.com

Remote MCP installation

  1. 1. Add the server URL to an OAuth-compatible MCP client.
  2. 2. Choose Connect or Authenticate in the client. Your browser opens Vsyble.
  3. 3. Sign in and review search, enrichment, outreach, sending permissions, and use of your Vsyble allowances.
  4. 4. Return to the client. The tools become available as soon as authorization finishes.

Claude Code

Add Vsyble to the current project, then open the MCP menu in Claude Code and choose Authenticate.

Shell
claude mcp add --scope project --transport http vsyble "https://mcp.vsyble.com"

JSON configuration

Use this shape in clients that support remote HTTP MCP servers through a JSON configuration file.

JSON
{
 "mcpServers": {
 "vsyble": {
 "type": "http",
 "url": "https://mcp.vsyble.com"
 }
 }
}

Authentication

The hosted server uses OAuth with PKCE and dynamic client registration. Each approval creates a separate connection for that client, and Vsyble refreshes access in the background when the client supports it.

Remote access requires a paid Vsyble plan. Searches and uncached enrichment use your normal allowances and connection spend limits. You can review or revoke a connection at any time from the MCP page in the Vsyble app.

Available tools

people_search

Find professionals by role, company, location, education, seniority, and LinkedIn availability. The client asks how many results you want, from 1 to 25.

company_search

Find companies using firmographic, funding, hiring, and technology filters. The client asks how many results you want, from 1 to 25.

enrich

Add contact details or deeper company intelligence to selected search results. Pass the search’s request_id and 1-based result numbers; repeat the same selection to continue pending work.

outreach_workspace

Get your current Vsyble workspace ID.

outreach_campaigns

List campaigns, registered sending mailboxes, and connected sending accounts. Does not send messages.

outreach_campaign

Read a campaign, its current revision, enrolled leads, message revisions, holds, and delivery metrics.

outreach_save_campaign

Create or update a draft or paused campaign in review mode. Read the latest revision before editing. Does not activate sending; use outreach_set_campaign_status after explicit user approval.

outreach_set_campaign_status

Activate, pause, or stop a campaign at its exact revision. Activation can send approved messages and requires explicit user authorization. Existing approval, suppression, verification, pacing, and sending limits still apply.

outreach_drafts

List existing drafts available for enrollment, with their IDs and revisions.

outreach_drafts_from_contacts

Create draft placeholders from explicitly selected existing CRM contact record IDs. Does not discover contacts or send messages.

outreach_enroll_drafts

Enroll explicitly selected existing drafts at exact campaign and draft revisions. Can incur recipient verification and fit-scoring costs. Does not approve messages for sending.

outreach_prepare_messages

Prepare personalized messages for an existing enrollment, or selected candidates from an existing outbound run. Uses Vsyble's paid research and writing allowances. Returns a durable run ID; inspect existing work before retrying. Does not approve sending.

outreach_message

Read the exact saved message content, revision, and review state before editing or approving it.

outreach_edit_message

Edit an existing draft at its exact revision. Existing approvals are invalidated by content changes. Does not send the message.

outreach_submit_messages

Submit exact draft revisions for campaign approval without releasing mail.

outreach_submissions

List a campaign's message approval submissions.

outreach_submission

Read an approval submission and the exact messages proposed for sending.

outreach_decide_submission

Approve or request changes to a submission through Vsyble's existing administrator approval gate. Approval can release mail; show the messages and obtain explicit user authorization before approving.

outreach_review_messages

Approve only explicitly reviewed draft revisions. Can release mail in an active campaign; requires explicit user authorization. Does not bypass required administrator approval.

outreach_cancel_enrollment

Exclude an enrolled lead and cancel its unsent messages.

outreach_replies

Read campaign replies and their classifications. Does not send replies.

Existing connections need fresh consent for outreach. Campaign reads and controls do not use model tokens. Message preparation, enrollment, verification, and sending use the same workflow allowances as the app. Sending requires explicit approval and remains subject to administrator review and sending limits.

Advanced options

For local development or headless automation, Vsyble also supports a local STDIO server and API keys. Install the package with npm i vsyble, then run npx vsyble setup. API keys and active OAuth connections are managed in the Vsyble app.

© 2026 Vsyble. All rights reserved.