# vCard generator

Create a vCard (.vcf) contact file, version 3.0 or 4.0, with fields properly escaped and long lines folded.

- Endpoint: `POST https://setget.net/v1/tools/vcard` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `vcard`
- Page: https://setget.net/tools/vcard

## Inputs

- `first_name` (optional, string): Given name.
- `last_name` (optional, string): Family name.
- `organisation` (optional, string): Company or organisation.
- `job_title` (optional, string): Job title or role.
- `phone` (optional, string): Phone number, ideally in international form.
- `phone_type` (optional, string, one of `cell`, `work`, `home`, default `"cell"`): Kind of phone number.
- `email` (optional, string): Email address.
- `url` (optional, string): Website address, including https://.
- `street` (optional, string): Street address.
- `city` (optional, string): Town or city.
- `region` (optional, string): County, state or province.
- `postcode` (optional, string): Postcode or ZIP code.
- `country` (optional, string): Country.
- `note` (optional, string): Free-text note. Line breaks are kept.
- `version` (optional, string, one of `3.0`, `4.0`, default `"3.0"`): vCard version. 3.0 is the most widely supported.

## Example 1

```json
{"input":{"first_name":"Sam","last_name":"Rivera","organisation":"Example Ltd","phone":"+44 20 7946 0123","email":"sam@example.com"}}
```

Result:

```json
{"text":"BEGIN:VCARD\r\nVERSION:3.0\r\nN:Rivera;Sam;;;\r\nFN:Sam Rivera\r\nORG:Example Ltd\r\nTEL;TYPE=CELL:+44 20 7946 0123\r\nEMAIL;TYPE=INTERNET:sam@example.com\r\nEND:VCARD\r\n","filename":"sam-rivera.vcf"}
```

## Example 2: Version 4.0 with escaped punctuation

```json
{"input":{"first_name":"Alex","organisation":"Smith, Jones; Partners","city":"Leeds","country":"United Kingdom","version":"4.0"}}
```

Result:

```json
{"text":"BEGIN:VCARD\r\nVERSION:4.0\r\nN:;Alex;;;\r\nFN:Alex\r\nORG:Smith\\, Jones\\; Partners\r\nADR:;;;Leeds;;;United Kingdom\r\nEND:VCARD\r\n","filename":"alex.vcf"}
```

**How do I use the result?** Save the text as a file ending in .vcf and open it on a phone or in a mail program to add the contact.

**Which version should I choose?** Use 3.0 unless you know the receiving system wants 4.0. Every common address book reads 3.0.
