# MCP Server — MCP Village

Remote MCP server that lets your AI assistant build and manage this website directly from chat.

**Endpoint:** `https://mcpvillage.com/mcp`

## What this server does

Connect your AI (Claude, ChatGPT, Grok, Kimi, or any MCP-capable client) to this
server and you can create pages, edit content, upload images, manage blog posts and
products, read form submissions, and update business details — all by chatting. No
code, no dashboard, no waiting on a web designer.

## How to connect

This is a **remote (HTTP) MCP server**. Any MCP-capable AI client can use it —
the steps are the same everywhere, only the wording in each app differs.

**1. Add it by URL.** In your client's integrations / connectors / MCP settings,
add a new remote (HTTP) server and paste:

```
https://mcpvillage.com/mcp
```

Most clients pick it up from the URL alone and walk you through a one-time
sign-in (see Authentication below).

**2. Or add it by config file.** For clients configured with JSON, add it under
`mcpServers`:

```json
{
  "mcpServers": {
    "MCP Village": {
      "url": "https://mcpvillage.com/mcp"
    }
  }
}
```

**3. stdio-only clients.** If your client can't connect to a remote server
directly, bridge it:

```bash
npx mcp-remote https://mcpvillage.com/mcp
```

## Available tools / capabilities

**Site information** — Read and update your business name, contact details, logo,
timezone, and language (`get_site`, `update_site`).

**Pages & files** — List, read, create, edit, rename, move, and delete pages,
layouts, stylesheets, and templates. Upload images and other media via URL to the
CDN. Restore anything deleted within ~30 days (`list_files`, `read_file`,
`write_file`, `move_file`, `delete_file`, `upload_file`, `list_trash`, `restore`).

**Blog posts, articles & products** — Browse, create, update, publish, draft, and
delete typed content. Products support price and currency fields (`list_posts`,
`get_post`, `create_post`, `update_post`, `delete_post`).

**Form submissions & leads** — Read what visitors submitted through contact, lead,
review, and order forms. Approve or mark as spam to control on-site display. Export
to CSV or JSON (`list_submissions`, `get_submission`, `update_submission`,
`export_submissions`).

**Analytics** — Traffic overview: views, clicks, conversions, top pages, and
referrers over 24 h / 7 d / 30 d / 90 d. Drill into any path (`get_analytics`,
`export_analytics`).

**Export & backup** — Download a full site ZIP (all files + manifest), export posts
or analytics as CSV/JSON. Complete data portability, any time (`export_site`,
`export_posts`).

**Support** — Ask about pricing, plans, domains, storage, and billing; escalate to
a human when self-serve can't resolve it (`support`, `open_ticket`).

## Example prompts

- "Create a landing page for my cleaning business with a quote form and publish it."
- "Write a blog post announcing our new weekend hours and tag it 'news'."
- "Show me the messages from my contact form this week and mark the spam ones."

## Authentication

**One-click OAuth (recommended):** When you add this server in a supported client
(Claude Desktop, Claude.ai, Cursor), it will prompt you to sign in. The site owner
approves access once — nothing to paste or copy. Discovery metadata is at
`/.well-known/oauth-protected-resource`.

**Bearer token (manual fallback):** If your client doesn't support OAuth, use a
static token instead. Sign in at [admin.mcpvillage.com](https://admin.mcpvillage.com),
open this site, go to **Connect**, and create a connection — then send the token it
gives you as `Authorization: Bearer <token>` on every request.

## Technical details

- **Transport:** Streamable HTTP (JSON-RPC 2.0) — `POST` to start a session
- **Endpoint:** `https://mcpvillage.com/mcp`
- **Auth:** OAuth 2.1 + PKCE (preferred) or Bearer `mcp_connections` token
- **Limits:** Unlimited edits; storage and bandwidth limits depend on plan