Connects AI agents to a headless CMS to model, import, and wire content for AI-built websites.
Also known as mapledhq/agent-kit, agent-kit, @mapled/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.23.3
- Last commit
- Nov 8, 2026
- License
- —
What is Mapled MCP?
Mapled connects AI agents to a headless CMS to model, import, and wire content for AI-built websites.
Summary generated from the project's README
About Mapled MCP server
Mapled provides a hosted headless CMS specifically designed for websites constructed by AI agents. It allows developers and AI tools to bridge the gap between content management and code by modeling, importing, and wiring content directly into a site. Users can connect their projects by running the npx @mapled/cli connect command or by using the Mapled MCP server via a remote URL.
This server works with any MCP client that supports OAuth, including Cursor and VS Code. For environments that do not support OAuth, the @mapled/mcp package provides a stdio server that utilizes a project token. The system includes various SDKs like @mapled/next and @mapled/react to help the site read published content. It also offers a dedicated plugin for Claude Code to simplify the integration process.
What you can do with it
- 1Connect a website to MapledAn AI agent can link a local codebase to the headless CMS using a specific command.
- 2Install Mapled in Claude CodeDevelopers can add the Mapled skill and MCP server directly to their Claude Code environment.
- 3Integrate with IDEs via MCPYou can add the remote MCP server to Cursor or VS Code to manage content through your editor.
Written from the project's README. Every use case is checked against a quote from it.
How to install Mapled MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Mapled MCP in Claude Code
$ claude mcp add --env 'MAPLED_MCP_TOKEN=<YOUR_MAPLED_MCP_TOKEN>' agent-kit -- npx -y @mapled/mcpInstall Mapled MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent-kit": {
"command": "npx",
"args": [
"-y",
"@mapled/mcp"
],
"env": {
"MAPLED_MCP_TOKEN": "<YOUR_MAPLED_MCP_TOKEN>"
}
}
}
}Install Mapled MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agent-kit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mapled/mcp"
],
"env": {
"MAPLED_MCP_TOKEN": "<YOUR_MAPLED_MCP_TOKEN>"
}
}
}
}Install Mapled MCP in VS Code CLI
$ code --add-mcp '{"name":"agent-kit","type":"stdio","command":"npx","args":["-y","@mapled/mcp"],"env":{"MAPLED_MCP_TOKEN":"<YOUR_MAPLED_MCP_TOKEN>"}}'Install Mapled MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"agent-kit": {
"command": "npx",
"args": [
"-y",
"@mapled/mcp"
],
"env": {
"MAPLED_MCP_TOKEN": "<YOUR_MAPLED_MCP_TOKEN>"
}
}
}
}Install Mapled MCP in Codex
$ codex mcp add agent-kit --env 'MAPLED_MCP_TOKEN=<YOUR_MAPLED_MCP_TOKEN>' -- npx -y @mapled/mcpInstall Mapled MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agent-kit] command = "npx" args = ["-y", "@mapled/mcp"] [mcp_servers.agent-kit.env] MAPLED_MCP_TOKEN = "<YOUR_MAPLED_MCP_TOKEN>"
Install Mapled MCP in Gemini CLI
$ gemini mcp add -s user -e 'MAPLED_MCP_TOKEN=<YOUR_MAPLED_MCP_TOKEN>' agent-kit npx -- -y @mapled/mcpInstall Mapled MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agent-kit": {
"command": "npx",
"args": [
"-y",
"@mapled/mcp"
],
"env": {
"MAPLED_MCP_TOKEN": "<YOUR_MAPLED_MCP_TOKEN>"
}
}
}
}Configuration
MAPLED_MCP_TOKENRequiredSecretA project token from Mapled: project → Integrations → Connect with AI → Other ways to connect
| Name | Description | |
|---|---|---|
| MAPLED_MCP_TOKEN | A project token from Mapled: project → Integrations → Connect with AI → Other ways to connect | RequiredSecret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablemapledhq/agent-kit is public and reachablegithub.com/mapledhq/agent-kit ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-12github.com/mapledhq/agent-kit ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @mapled/mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubMapled for AI agents
Mapled is a hosted headless CMS for sites built with AI: the owner edits content in Mapled, the site reads published content through a small SDK, and an AI agent connects the two from a single prompt.
Connect a site
In the AI tool that has the site's code open, paste the prompt from Mapled (project → Connect with AI), or ask:
Connect this site to Mapled. Run
npx -y @mapled/cli connectand follow the guide it prints.
The browser opens once to authorize; the agent does the rest. The guide for agents: https://api.mapled.io/agents.md
Claude Code plugin
claude plugin marketplace add mapledhq/agent-kit
claude plugin install mapled@mapled
The plugin brings the Mapled MCP server (OAuth in the browser, no token) and the mapled skill.
MCP server
Any client that supports remote MCP servers with OAuth:
https://api.mapled.io/mcp
One click: Add to Cursor · Add to VS Code · Add to VS Code Insiders
In Claude Code: claude mcp add --transport http mapled https://api.mapled.io/mcp. For clients without OAuth, the stdio server with a project token: @mapled/mcp.
Packages
@mapled/cli— sign-in, every tool from the shell,doctor@mapled/mcp— the tools, described@mapled/next·@mapled/client·@mapled/react·@mapled/vanilla— the site SDKs
Mapled MCP questions
How do I add Mapled MCP to Claude Code?
Run claude mcp add --env 'MAPLED_MCP_TOKEN=<YOUR_MAPLED_MCP_TOKEN>' agent-kit -- npx -y @mapled/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Mapled MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I connect my site to Mapled using an AI agent?
Paste the prompt from the Mapled project section or instruct the agent to run npx -y @mapled/cli connect and follow the printed guide.
Does the Mapled MCP server require an API token?
The remote MCP server uses OAuth in the browser and does not require a token, though a stdio server version is available using a project token.
What SDKs are available for integrating Mapled into a website?
Mapled provides several SDKs including @mapled/next, @mapled/client, @mapled/react, and @mapled/vanilla.