INDIVIDUAL MCP TOOL

virtuous_search_contacts

Find contacts whose name, email, phone or address fully or partially matches a search string.

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://virtuous-crm.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for virtuous_search_contacts and invoke it with your own arguments.

{}

Potential side effects detected · medium confidence · heuristic, not a guarantee.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.virtuous-crm-mcp]
url = "https://virtuous-crm.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "virtuous-crm-mcp": {
      "type": "http",
      "url": "https://virtuous-crm.usefulapi.io/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: virtuous-crm-mcp
Remote MCP URL: https://virtuous-crm.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "virtuous-crm-mcp": {
      "url": "https://virtuous-crm.usefulapi.io/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "virtuous-crm-mcp": {
      "type": "http",
      "url": "https://virtuous-crm.usefulapi.io/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "virtuous-crm-mcp",
  "transport": "streamable-http",
  "url": "https://virtuous-crm.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

virtuous_get_current_organization — Fetch the Virtuous organization this API key acts in — its name, time zone and culture, and whether the key's user is an administrator.
virtuous_search — Full-text search across contacts, individuals and entities (campaigns, projects, segments, tags) — the same search as the Virtuous search bar.
virtuous_get_contact — Fetch one contact (household, organization, foundation .
virtuous_find_contact — Look up a single contact by email address, or by an external reference (reference source + id, e.
virtuous_list_contact_individuals — List the individuals (people) that belong to a contact/household, with names, birth dates, and their emails and phones (contact methods).
virtuous_list_contact_notes — List the notes logged on a contact — calls, meetings, emails and other touchpoints — with type, date, text and author.
virtuous_list_contact_tags — List the tags applied to a contact (contactTagId, tagId, name).
virtuous_list_contact_gifts — List a contact's giving history: gift id, type, date, amount, segment and batch.