Jaybird Digital
OfficialREADME.md
# Jaybird Digital MCP server
Connect your AI tool to Jaybird Digital, and it can build a website for you and hand back a live link. No account, sign-in, API key or payment is needed to start.
It works in Claude, ChatGPT and other AI tools that let you add a connector or an MCP server. Add this address:
```text
https://jaybirddigital.com/api/start/mcp
```
[Jaybird Digital](https://jaybirddigital.com) builds, hosts and manages websites for small businesses. It is based in San Antonio, Texas. The server is hosted by Jaybird Digital. This repository holds setup steps, config files and an agent skill, not the server's code.
- [Add it to your AI tool](#add-it-to-your-ai-tool)
- [What your AI tool can do](#what-your-ai-tool-can-do)
- [What happens to the draft](#what-happens-to-the-draft)
- [Try it](#try-it)
- [For developers](#for-developers)
- [Agent skill](#agent-skill)
- [Privacy and terms](#privacy-and-terms)
- [Support](#support)
## Add it to your AI tool
Add the address above in your AI tool's connector or MCP settings. You do not need to sign in. If you already have a Jaybird Digital account, see [If you have an account](#if-you-have-an-account). Ready-made config files for each tool are in [examples/](examples/).
### Claude (web, desktop and mobile)
1. Open **Customize > Connectors**, choose **Add**, then **Add custom connector**.
2. For the name, enter `Jaybird Digital`. For the URL, enter `https://jaybirddigital.com/api/start/mcp`. Choose **Continue**.
3. If Claude shows the settings it detected, choose **Continue** again.
4. Under **Authentication**, choose **Sign in when needed**. You can use it without an account, and sign in later if you get one. Under **OAuth client**, keep the option marked **Detected**, or choose **Register automatically**.
5. Choose **Add**. In a chat, open **+ > Connectors** and turn Jaybird Digital on.
You cannot change the sign-in choice after you add the connector. To change it, remove the connector and add it again.
On Team and Enterprise plans, an Owner adds the connector first, under **Organization settings > Connectors** (**Add**, then **Custom**). Members then open **Customize > Connectors**, find Jaybird Digital (marked Custom) and choose **Connect**. Your plan and workspace settings can affect whether you can add custom connectors.
### ChatGPT
Jaybird Digital is listed as an app in ChatGPT. Open **Plugins** in ChatGPT, look up Jaybird Digital by name and connect it. Then type **@** in a chat to pick it.
You can also add the server yourself. That needs ChatGPT on the web and a Business, Enterprise or Edu plan. On a Business plan, only admins and owners can add it.
1. Go to [chatgpt.com/plugins](https://chatgpt.com/plugins), choose **+**, then **Add custom MCP server**.
2. Enter the name `Jaybird Digital`, a short description, and the URL `https://jaybirddigital.com/api/start/mcp`.
3. Under authentication, choose the mixed option, where OAuth sign-in is optional. You can use it without an account, and sign in later if you get one.
4. Confirm the notice, then choose **Create as a plugin**.
5. Review the tools, install it, and type **@** in a chat to pick it.
### Claude Code
```sh
claude mcp add --transport http jaybird-digital https://jaybirddigital.com/api/start/mcp
```
Add `--scope user` to use it in every project. If you have a Jaybird Digital account, run `claude mcp login jaybird-digital` to sign in.
To add the server and the [agent skill](#agent-skill) together, install the plugin from this repository:
```text
/plugin marketplace add Jaybird-Digital/jaybird-digital-mcp
/plugin install jaybird-digital@jaybird-digital
```
### Codex
```sh
codex mcp add jaybird-digital --url https://jaybirddigital.com/api/start/mcp
```
Or add this to `~/.codex/config.toml`:
```toml
[mcp_servers.jaybird-digital]
url = "https://jaybirddigital.com/api/start/mcp"
```
If you have a Jaybird Digital account, run `codex mcp login jaybird-digital` to sign in.
### Cursor
[](https://cursor.com/en/install-mcp?name=jaybird-digital&config=eyJ1cmwiOiJodHRwczovL2pheWJpcmRkaWdpdGFsLmNvbS9hcGkvc3RhcnQvbWNwIn0%3D)
Or add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
```json
{
"mcpServers": {
"jaybird-digital": {
"url": "https://jaybirddigital.com/api/start/mcp"
}
}
}
```
### VS Code
[](https://insiders.vscode.dev/redirect/mcp/install?name=jaybird-digital&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fjaybirddigital.com%2Fapi%2Fstart%2Fmcp%22%7D)
The button opens VS Code, where you review the server before you install it. You can also run **MCP: Add Server** from the Command Palette and choose HTTP.
To add it by hand, put this in `.mcp.json` at the root of your workspace:
```json
{
"mcpServers": {
"jaybird-digital": {
"type": "http",
"url": "https://jaybirddigital.com/api/start/mcp",
"tools": ["*"]
}
}
}
```
Deprecated: `.vscode/mcp.json`, with a `servers` key, belongs to an older VS Code setup that VS Code plans to remove in February 2027. Use the root `.mcp.json` above. An existing older setup looks like this:
```json
{
"servers": {
"jaybird-digital": {
"type": "http",
"url": "https://jaybirddigital.com/api/start/mcp"
}
}
}
```
Then ask for the website in the chat view, in agent mode.
### Gemini CLI
Install the extension. It adds the server, the [agent skill](#agent-skill) and a short guide:
```sh
gemini extensions install https://github.com/Jaybird-Digital/jaybird-digital-mcp
```
Run this in your shell, not inside a Gemini CLI session, then restart Gemini CLI. To add only the server:
```sh
gemini mcp add --transport http jaybird-digital https://jaybirddigital.com/api/start/mcp
```
If you have a Jaybird Digital account, run `/mcp auth jaybird-digital` in a Gemini CLI session to sign in.
### Windsurf
In Windsurf, open the MCP settings and choose to open the MCP config file (`mcp_config.json`; older installs keep it at `~/.codeium/windsurf/mcp_config.json`). Add:
```json
{
"mcpServers": {
"jaybird-digital": {
"serverUrl": "https://jaybirddigital.com/api/start/mcp"
}
}
}
```
### Cline
In Cline, open **MCP Servers**, then the **Remote Servers** tab. Enter the name `jaybird-digital` and the URL, choose **Streamable HTTP**, then **Add Server**. Or add this to `cline_mcp_settings.json`:
```json
{
"mcpServers": {
"jaybird-digital": {
"type": "streamableHttp",
"url": "https://jaybirddigital.com/api/start/mcp",
"disabled": false,
"autoApprove": []
}
}
}
```
Keep `"type": "streamableHttp"`. Without it, Cline uses the older SSE transport.
### Other AI tools
Any AI tool that can connect to a remote MCP server over Streamable HTTP can use the address above. The server answers POST requests and does not stream over GET. A tool that can only call web addresses can use the same operations through the [HTTP API](https://jaybirddigital.com/openapi.json).
### If you have an account
Signing in is optional. Sign in only if you already have a Jaybird Digital account. Then the websites your AI tool starts join your account, and it can work on your other websites too.
- Claude: choose **Sign in when needed** when you add the connector. Claude asks you to sign in when your account is needed.
- ChatGPT: if you add the server yourself, choose the mixed option, where OAuth sign-in is optional.
- Claude Code: run `claude mcp login jaybird-digital`.
- Codex: run `codex mcp login jaybird-digital`.
- Gemini CLI: run `/mcp auth jaybird-digital` in a session.
- Other AI tools: ask for something that needs your account, such as a list of your websites. If your tool does not offer a sign-in, also add the account server, `https://jaybirddigital.com/api/mcp`. It asks you to sign in when you add it.
## What your AI tool can do
This list is a reference for developers. You do not need it to get started.
<!-- tools:start -->
These 11 tools work without signing in:
| Tool | What it does |
| --- | --- |
| `start_website` | Creates a new, empty website and returns its websiteId, the editKey for changing it, the viewUrl where it can be seen, the keepUrl where the person keeps it, photoLink, siteZip, and the rules and size limits its files must meet. |
| `save_website_files` | Adds or replaces files on a website and checks every page against the rules start_website returned. |
| `edit_website_file` | Changes part of one saved page, stylesheet or script in place. |
| `save_website_pictures` | Saves pictures the person gave you, such as photos they uploaded in the conversation, as files on a website, without sending their bytes as text. |
| `get_picture_upload_link` | Makes a link where the person adds their own photos to a website from their phone or computer, so the photos never pass through the conversation. |
| `list_website_files` | Lists every file saved on a website, with each path and its size in bytes, beside the viewUrl, keepUrl, pages, passed and any problems. |
| `read_website_file` | Returns one saved file from a website with its path, encoding and content: pages, stylesheets and scripts as utf8 text, and fonts as base64. |
| `check_website_on_phone` | Opens a website's pages in a real browser at a phone's size and says, page by page, what a phone visitor would hit. |
| `search_domains` | Asks a domain registrar, live, which names can be registered, and returns up to about a dozen, each with its name, whether it is available and whether it is premium. |
| `delete_website` | Permanently deletes a whole website: every file, its address and its keep link. |
| `delete_website_file` | Removes one saved file from a website, then checks the remaining pages against the rules start_website returned, and returns the same report as save_website_files. |
This one needs the person to sign in first:
- `list_sites`: Lists the websites in the person's Jaybird Digital account, sorted by name, with each one's id, name and live address.
<!-- tools:end -->
When you sign in with a Jaybird Digital account, the same server also offers tools for the websites in your account. The server returns its file rules and size limits when a website starts.
## What happens to the draft
- Your AI tool gets a live link to the draft. The draft has its own address on jaybirdsites.com, with a bar that says it is a draft and a link to report it.
- The draft stays up for 7 days. It is hidden from search engines, and its pages cannot ask for passwords or card numbers.
- Until you sign in, only the chat that made the draft can change it.
- Save the draft link and the keep link your AI tool gives you. Without an account, a new chat cannot find the draft again.
- To keep the website, open the keep link your AI tool gives you. Keeping it on a domain of its own is the Jaybird Digital plan: $7 a month or $70 a year. Domain names cost extra. If you cancel within 14 days of your first payment, you get a full refund. See [pricing](https://jaybirddigital.com/pricing).
- The 7-day draft costs nothing and needs no account.
- Signing in is optional. If you have a Jaybird Digital account, sign in as shown in [If you have an account](#if-you-have-an-account). The websites your AI tool starts then join your account, it can find them again in a later chat, and it can work on your other websites too.
## Try it
Type something like this to your AI tool once the server is added:
> Use Jaybird Digital to make a simple website for Harbor & Pine Bakery, a neighborhood bakery in Duluth. Show our hours, a menu of breads and pastries, and how to order for pickup.
> Build a one-page website for my house-cleaning business, Bright Corner Cleaning, in San Antonio. We clean homes and small offices. People book by calling 210-555-0142.
> Check my draft website on a phone and fix anything that is hard to read or tap. Then look up a few domain names for Bright Corner Cleaning.
Your AI tool should ask for anything it needs, such as your hours, rather than make it up.
## For developers
The server is a remote MCP server that uses Streamable HTTP.
| What | Where |
| --- | --- |
| MCP server, sign-in optional | `https://jaybirddigital.com/api/start/mcp` (Streamable HTTP, POST only, no session ID) |
| MCP server for account owners, sign-in first | `https://jaybirddigital.com/api/mcp` |
| HTTP API (OpenAPI 3.0) | https://jaybirddigital.com/openapi.json, starting with `POST /api/start/websites` |
| llms.txt | https://jaybirddigital.com/llms.txt |
| Agent instructions | https://jaybirddigital.com/skill.md |
| Server card | https://jaybirddigital.com/.well-known/mcp/server.json |
| OAuth protected-resource metadata | https://jaybirddigital.com/.well-known/oauth-protected-resource/api/start/mcp |
| OAuth authorization server metadata | https://jaybirddigital.com/.well-known/oauth-authorization-server |
| Human guide | https://jaybirddigital.com/mcp |
Sign-in uses OAuth with PKCE (S256) and dynamic client registration.
The server is published in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=com.jaybirddigital) as `com.jaybirddigital/website`. It is also listed on [Glama](https://glama.ai/mcp/connectors/com.jaybirddigital/website) and [mcp.so](https://mcp.so/servers/jaybird-digital).
[`server.json`](server.json) in this repository mirrors the live server card and adds this repository's address. A weekly [workflow](.github/workflows/sync.yml) keeps it, the tool list above and the agent skill in step with the live server.
## Agent skill
[`skills/build-a-website/SKILL.md`](skills/build-a-website/SKILL.md) follows the [Agent Skills](https://agentskills.io) format. It tells an AI agent how to start a website, save its pages, check it on a phone and hand over the link. Ways to install it:
- With the skills CLI: `npx skills add Jaybird-Digital/jaybird-digital-mcp --skill build-a-website`
- As a Claude Code plugin, which also adds the server. See [Claude Code](#claude-code). The skill then appears as `/jaybird-digital:build-a-website`.
- As part of the [Gemini CLI extension](#gemini-cli).
- By hand: copy the `skills/build-a-website` folder into your agent's skills folder, for example `~/.claude/skills/`.
The skill only helps when the server is connected. It tells the agent to follow the person's wishes if they want a different builder or host.
## Privacy and terms
- Privacy: https://jaybirddigital.com/privacy
- Terms: https://jaybirddigital.com/terms
## Support
Email steve@jaybirddigital.com with questions, or if a draft should come down. Setup help for each AI tool: https://jaybirddigital.com/mcp
## Names and license
ChatGPT, Claude, Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf and Cline are named only to show which tools can connect. Product names belong to their owners and do not imply endorsement.
The docs and config files in this repository are under the [MIT License](LICENSE). The Jaybird Digital name and the logo files in [assets/](assets/) are not covered by the MIT License. The hosted service is covered by Jaybird Digital's [Terms](https://jaybirddigital.com/terms).
This server cannot be deployed