Basemodo MCP server
Commit Oct 27, 2026Allows an AI agent to deploy, manage, and fix small software applications on a personal cloud with integrated SQLite databases.
Also known as basemodocom/agent, agent
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 27, 2026
- License
- MIT
What is Basemodo MCP?
Basemodo allows an AI agent to deploy, manage, and fix small software applications on a personal cloud with integrated SQLite databases.
Summary generated from the project's README
About Basemodo MCP server
Basemodo provides a personal cloud environment designed for deploying and managing small software applications. It allows AI agents to build, run, and maintain apps that include integrated SQLite databases. Users can interact with the service through a Remote MCP server via HTTPS or by using the Basemodo CLI. The setup requires an OAuth sign-in through a browser to establish a connection without storing credentials in the plugin itself.
Developers use this server to automate the entire application lifecycle. An agent can generate an app from a template, deploy code from a GitHub repository, or manage existing deployments by reading logs and restarting services. The system supports advanced management tasks such as running SQL commands, performing database backups, managing secrets, and configuring custom domains. While the agent handles the technical execution, users maintain control through a Devices page where access can be revoked at any time.
What you can do with it
- 1Automated application generationAsk your agent to create a specific tool from a template and provide a live URL.
- 2Debugging and maintenanceInstruct the agent to investigate application errors by analyzing logs and applying fixes.
- 3Database managementDirect the agent to execute SQL queries or manage data backups and restorations.
- 4Deployment from GitHubHave the agent deploy a project directly from a remote repository and monitor the build process.
Written from the project's README. Every use case is checked against a quote from it.
How to install Basemodo MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Basemodo MCP in Claude Code
$ claude mcp add --transport http agent https://mcp.basemodo.com/Install Basemodo MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent": {
"url": "https://mcp.basemodo.com/"
}
}
}Install Basemodo MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agent": {
"type": "http",
"url": "https://mcp.basemodo.com/"
}
}
}Install Basemodo MCP in VS Code CLI
$ code --add-mcp '{"name":"agent","type":"http","url":"https://mcp.basemodo.com/"}'Install Basemodo MCP in Codex
$ codex mcp add agent --url https://mcp.basemodo.com/Install Basemodo MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agent] url = "https://mcp.basemodo.com/"
Install Basemodo MCP in Gemini CLI
$ gemini mcp add -s user --transport http agent https://mcp.basemodo.com/Install Basemodo MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agent": {
"url": "https://mcp.basemodo.com/",
"type": "http"
}
}
}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 reachablebasemodocom/agent is public and reachablegithub.com/basemodocom/agent ↗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-11-05github.com/basemodocom/agent ↗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 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 GitHubBasemodo
Deploy, share and fix Apps on Basemodo, the cloud for small software, from your agent: Basemodo's Skills, and its Remote MCP to act through.
Basemodo is your personal cloud: it puts the Apps you built online for you and the people you choose. Your agent deploys an App, and Basemodo builds it, runs it on a machine of its own with a SQLite database that keeps its data, and gives back its address. A new App is private: only the people you invite can open it, and Basemodo signs them in, so the App needs no login of its own.
Signed in as you, your agent can:
- build an App from the chat: you say what it is for, and your agent starts it from one of Basemodo's Templates, writes it, deploys it and fixes it, with no code to read and no folder or repository of yours;
- deploy an App from a GitHub repository, follow its build, and roll back a Deploy that went wrong;
- share an App by email with Members or Editors, or open it to anyone with the link or to everyone;
- read an App's status and Logs to find out why it is broken or slow, and restart it;
- run SQL on its database, take a Backup and restore one;
- keep API keys out of the code as Secrets, and add a custom domain.
Your agent acts only on your own Apps on Basemodo, and you revoke it at any time on the Devices page of basemodo.com. Basemodo needs a Plan, from $5 a month for one App; the people you share an App with never pay.
Install
In Claude Code: /plugin install basemodo --marketplace basemodocom/agent, or before version 2.1.275, /plugin marketplace add basemodocom/agent then /plugin install basemodo@basemodo.
Try it
Once the plugin is installed, ask your agent:
- "Build me an App on Basemodo for my team's lunch rota and give me the link"
- "Share my Basemodo App with my team"
- "My App on Basemodo is broken: read its Logs and fix it"
What the plugin runs, sends and fetches
- The Remote MCP, https://mcp.basemodo.com, the plugin's only MCP server. Your agent connects to it over HTTPS, and you sign in to Basemodo with OAuth in your browser, where you approve the connection; the plugin carries no credential. Your agent sends it the tool calls it makes for you (an App's name, a GitHub repository to deploy, SQL to run, a Secret to set) and reads their answers. Without a terminal, the Skills have your agent push a new App's code to a GitHub repository of yours, which the Remote MCP deploys.
- The Skills, in
skills/: instructions your agent reads. They run nothing by themselves. - The CLI, with a terminal: the Skills have your agent run
basemodocommands, which act on your Apps through Basemodo's API, https://api.basemodo.com, signed in as you.basemodo deploypacks the App's folder (without.gitand the files it ignores) and uploads it to Basemodo;basemodo pullandbasemodo downloadwrite an App's code and data into a folder on your computer;basemodo feedbacksends what you write to Basemodo. - Installing the CLI: when
basemodois missing, the Skills offer to install it and, once you agree, run the install script the plugin carries, with setup left out:skills/basemodo/scripts/install.shon macOS and Linux,skills/basemodo/scripts/install.ps1on Windows, the script basemodo.com's install line serves. It downloads thebasemodoCLI from its releases, https://github.com/basemodocom/cli/releases, checks it against the release's checksums, and adds its folder to your PATH. Your agent then runsbasemodo setup --user, which writes Basemodo's Skills where your agents read them. You sign the CLI in yourself, withbasemodo loginin your browser.
Links
- Documentation: https://basemodo.com/docs/mcp/claude-ai
- Support: https://basemodo.com/support
- Privacy policy: https://basemodo.com/privacy
- Terms of service: https://basemodo.com/terms
Basemodo MCP questions
How do I add Basemodo MCP to Claude Code?
Run claude mcp add --transport http agent https://mcp.basemodo.com/ in your terminal. Add --scope user to make it available in every project.
How do I add Basemodo MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I deploy an app using Basemodo?
You can build an app from a chat description using templates, or deploy an existing app directly from a GitHub repository.
Is the deployed application private?
Yes, new apps are private by default and only accessible to people you specifically invite.
How does the MCP server handle my credentials?
The plugin uses OAuth via your browser to approve connections, meaning the plugin itself carries no credentials.
Can I manage my application's database?
Yes, your agent can run SQL queries on the application's SQLite database and perform backups or restores.