VULK MCP server
Commit Oct 8, 2026Lets an AI assistant build and manage apps and websites by interacting with your VULK account and project briefs.
Also known as VULK-dev/vulk-mcp-server, vulk-mcp-server
- Stars
- 7
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Oct 8, 2026
- License
- MIT
What is VULK MCP?
VULK lets an AI assistant build and manage apps and websites by interacting with your VULK account and project briefs. It exposes 9 tools, such as list_projects, get_project, get_project_files.
Summary generated from the project's README
About VULK MCP server
VULK provides a remote MCP connector that allows AI assistants to manage app and website development through your existing VULK account. By using OAuth 2.0 with PKCE for authentication, the server connects your assistant to your projects without requiring a manual API key. Users can set this up in clients like Claude, Cursor, or Codex CLI by providing the remote server URL.
Developers use this tool to automate the creation and refinement of digital projects. The assistant can list projects, check credit balances, and monitor usage over the last 30 days. It can also initiate new builds using a written brief or send follow-up instructions to an ongoing project. While it can read source files on paid plans, it cannot perform actions like purchasing credits, changing subscription plans, or publishing a live site.
Specific tools include list_projects for viewing your work, create_project to start a new build, and continue_project to provide further directions. The assistant can also use stop_operation to halt a running build. The system handles project briefs up to 8,000 characters and uses request IDs to prevent duplicate builds.
What you can do with it
- 1Start a new website buildAsk the assistant to create a new project based on a specific written description.
- 2Refine an existing applicationProvide additional instructions to an ongoing project to update its design or functionality.
- 3Monitor project resourcesCheck your remaining credit balance and usage history to manage your account.
- 4Review project source codeAccess the file index or specific source files for a project if you have a paid plan.
Written from the project's README. Every use case is checked against a quote from it.
How to install VULK MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall VULK MCP in Claude Code
$ claude mcp add --transport http vulk-mcp-server https://app.vulk.dev/mcpInstall VULK MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"vulk-mcp-server": {
"url": "https://app.vulk.dev/mcp"
}
}
}Install VULK MCP in VS Code
.vscode/mcp.json
{
"servers": {
"vulk-mcp-server": {
"type": "http",
"url": "https://app.vulk.dev/mcp"
}
}
}Install VULK MCP in VS Code CLI
$ code --add-mcp '{"name":"vulk-mcp-server","type":"http","url":"https://app.vulk.dev/mcp"}'Install VULK MCP in Codex
$ codex mcp add vulk-mcp-server --url https://app.vulk.dev/mcpInstall VULK MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.vulk-mcp-server] url = "https://app.vulk.dev/mcp"
Install VULK MCP in Gemini CLI
$ gemini mcp add -s user --transport http vulk-mcp-server https://app.vulk.dev/mcpInstall VULK MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"vulk-mcp-server": {
"url": "https://app.vulk.dev/mcp",
"type": "http"
}
}
}VULK MCP tools 9
Detected from the READMElist_projectsget_projectget_project_filesget_usageopen_billingcreate_projectcontinue_projectget_operationstop_operation
| list_projects | — | |
| get_project | — | |
| get_project_files | — | |
| get_usage | — | |
| open_billing | — | |
| create_project | — | |
| continue_project | — | |
| get_operation | — | |
| stop_operation | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablevulk-dev/vulk-mcp-server is public and reachablegithub.com/vulk-dev/vulk-mcp-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-08github.com/vulk-dev/vulk-mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubVULK MCP connector
VULK builds apps and websites from a written brief. This connector lets an AI assistant work with your own VULK account once you have signed in and approved it.
- Server URL:
https://app.vulk.dev/mcp(aliashttps://mcp.vulk.dev/mcp) - Transport: remote, Streamable HTTP
- Authentication: OAuth 2.0 authorization code with PKCE (S256), dynamic client registration; no API key
- Documentation: https://support.vulk.dev/docs/api/mcp
- Privacy policy: https://vulk.dev/privacy-policy
What an assistant can do
- List your projects, read a project's details and, on a paid plan, its source files.
- Show your plan and renewal date, your credit balance and your usage over the last 30 days.
- Create a new project, or send the next instruction to an existing one. VULK builds it the way it does in its own editor, using the credits your plan already includes. The assistant can then read the progress, any questions VULK asks, and the link that opens the result in the editor.
- Stop a request that is still running.
What it cannot do
It cannot publish a site, buy credits, change your plan or delete a project: there is no tool for any of those. If your plan has no credits left, VULK refuses the request. There is no standalone image, video or audio generation tool; media is only ever generated as part of building a project, as one of its design assets.
Connect
-
Claude (claude.ai): Customize › Connectors › Add custom connector, name
VULK, URLhttps://app.vulk.dev/mcp. -
Claude Code:
claude mcp add --transport http vulk https://app.vulk.dev/mcp -
Codex CLI:
codex mcp add vulk --url https://app.vulk.dev/mcp codex mcp login vulk -
Cursor: add to
mcp.json:{ "mcpServers": { "vulk": { "url": "https://app.vulk.dev/mcp" } } } -
Any other MCP client that supports remote servers with OAuth: add the URL above.
The first time, you are sent to app.vulk.dev to sign in and see what the connection can do before you approve it.
Tools
| Tool | Scope | What it does |
|---|---|---|
list_projects |
projects.read |
Your projects |
get_project |
projects.read |
One project's details and links |
get_project_files |
projects.read |
The file index, or one source file per call (paid plans) |
get_usage |
usage.read |
Plan, renewal date, credit balance, 30-day usage |
open_billing |
none | Returns a link to your own billing page; changes nothing |
create_project |
projects.write |
Starts a build of a new project from your brief |
continue_project |
projects.write |
Sends the next instruction or answer to an existing project |
get_operation |
projects.read |
Reads the persisted state of a build you started |
stop_operation |
projects.write |
Asks VULK to stop a build that is still running |
Reading and building are separate permissions: a connection that was not granted projects.write never sees the tools that need it, and a call to one anyway returns a tool error that names the missing permission.
Permissions, data and revocation
- A connection lasts up to 90 days (refresh tokens rotate on every use) and you can remove it at any time in Settings › Integrations › Connected apps at app.vulk.dev.
- The connector reads and writes only inside the signed-in account: its projects, plan, credits and usage. The text you ask the assistant to build is sent to VULK as the project brief (up to 8,000 characters).
- Each build request carries a
request_id; repeating a request with the same id returns the same receipt instead of building twice.
Legacy local package
The npm packages vulk-mcp-server (1.1.0 and earlier) and @vulk/mcp-server (1.0.0) are separate local command-line packages (they run on your own machine) from before this connector. They authenticate with an API key (VULK_API_KEY) instead of OAuth and expose different tools. This connector does not use them, and their tool names and behaviour are not described here.
License
MIT. See LICENSE.
VULK MCP questions
How do I add VULK MCP to Claude Code?
Run claude mcp add --transport http vulk-mcp-server https://app.vulk.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add VULK MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does VULK MCP provide?
It exposes 9 tools, including list_projects, get_project, get_project_files, get_usage, open_billing.
What can the AI assistant do with VULK?
The assistant can list projects, read project details and source files, check your credit balance and usage, create new projects, and send instructions to existing ones.
Can the assistant publish a website or buy credits?
No, the assistant cannot publish sites, purchase credits, change your plan, or delete projects.
Does this server use an API key?
No, this connector uses OAuth 2.0 authorization code with PKCE for authentication.