# Vcard Generate — MCP tool `findutils:vcard_generate`

Generate a vCard (.vcf) contact card from name, organisation, emails, phones, address, URL, note and birthday. vCard 3.0 by default (imports into iOS Contacts, Google Contacts and Outlook), 4.0 on request. Values are escaped and long lines folded per RFC 6350.

- Category: generators
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/vcard-generate/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/vcard-generate/
- Same tool on the other surface: https://findutils.com/api/vcard-generate/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "vcard_generate",
      "arguments": {
        "full_name": "Ada Lovelace",
        "emails": [
          "ada@example.com"
        ],
        "phones": [
          "+44 20 7946 0000"
        ]
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `full_name` | string | yes | Display name (FN). Required. |
| `given_name` | string | no | First name (N given part). |
| `family_name` | string | no | Last name (N family part). |
| `organization` | string | no | Company or organisation (ORG). |
| `title` | string | no | Job title (TITLE). |
| `emails` | array | no | Email addresses (EMAIL). The first is marked preferred. |
| `phones` | array | no | Phone numbers (TEL), international format recommended. The first is marked preferred. |
| `street` | string | no | Street address (ADR street part). |
| `city` | string | no | City (ADR locality). |
| `region` | string | no | State, province or region (ADR region). |
| `postal_code` | string | no | Postal code (ADR). |
| `country` | string | no | Country (ADR). |
| `url` | string | no | Website (URL). |
| `note` | string | no | Free text (NOTE). |
| `birthday` | string | no | Birthday as YYYY-MM-DD (BDAY). |
| `version` | string (3.0 \| 4.0) | no | vCard version. Defaults to 3.0. Default: `"3.0"`. |

Example arguments (verified):

```json
{
  "full_name": "Ada Lovelace",
  "emails": [
    "ada@example.com"
  ],
  "phones": [
    "+44 20 7946 0000"
  ]
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/vcard-generate/execute \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "Ada Lovelace",
    "emails": [
      "ada@example.com"
    ],
    "phones": [
      "+44 20 7946 0000"
    ]
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/vcard-generate
```

Full REST reference: https://findutils.com/api/vcard-generate/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt