list_projects
List projects
List the projects you own or can access, newest first, with cursor pagination. view=active (default) hides archived and trashed projects; pass view=archived or view=trash to see those.
viewlimitcursor
io.github.Misar-AIPublished by GitHub account Misar-AIv3.0.0Updated Oct 25, 2026
Create, build and deploy projects, roll back with checkpoints, connect custom domains, and search…
MisarDev MCP lets an assistant create, edit, build and deploy MisarDev web projects, manage checkpoints and domains, and search code and the web.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.Misar-AI%2Fmisardev-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"misardev": {
"type": "http",
"url": "https://api.misar.io/dev/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}Create, build and deploy projects, roll back with checkpoints, connect custom domains, search your code and the web, and work your feed, follows and DMs — from any AI assistant.
80 tools · 5 prompts · 3 resources · 4 agent skills
Works with Claude (Desktop, Code, and web), Cursor, VS Code, Windsurf, Cline, Zed, Gemini CLI, ChatGPT, and any other MCP-compatible client — over stdio or Streamable HTTP.
Ready-made configs for every client live in connectors/.
Create an API key at https://misar.dev/settings/api-keys (Settings → API keys) — it starts with
mdk_ — and give it to the server in one of three ways: the
MISARDEV_API_KEY environment variable, your MCP client's env block, or
{ "api_key": "mdk_…" } in ~/.misardev/config.json.
Self-hosted instances: set MISARDEV_BASE_URL.
Reusable workflows your client exposes as slash-commands.
Read-only context an agent can attach without spending a tool call.
Bundled in skills/ — guidance an agent loads when a task matches.
Destructive and irreversible actions are annotated (destructiveHint) so
clients can prompt before running them. The skills instruct agents to confirm
before anything that sends mail, publishes content, or is otherwise visible to
other people.
Discovery (initialize, tools/list, prompts/list, resources/list)
never requires credentials, so registries can index the server without one.
Every action does.
MIT © Misar.AI
Source: README.md at commit 7143553
List projects
List the projects you own or can access, newest first, with cursor pagination. view=active (default) hides archived and trashed projects; pass view=archived or view=trash to see those.
viewlimitcursorGet project
Get one project by ID — name, description, settings, visibility, version and deployment fields. Read this before update_project so you change the current version, not a stale copy.
idrequiredCreate project
Create a new, empty project (optionally seeded with a file map). Counts against the plan's project quota. To start from a starter instead, use use_template.
namerequiredfilessettingsdescriptionUpdate project
Update a project's name, description, files, settings or visibility. Files passed here REPLACE the matching paths. Pass the `version` you read with get_project to avoid overwriting someone else's newer edit (the API answers 409 on a conflict).
idrequirednamefilesversionsettingsis_publicdescriptionDelete project
Move a project to the trash. It disappears from every list and route immediately; restore_project brings it back during the retention window. Confirm with the user first — anything published from it stops being editable.
idrequiredRestore project
Restore a project from the trash. A project that was archived before it was trashed returns to the archive, not to the active list.
idrequiredArchive project
Archive (archived=true) or un-archive (archived=false) a project. Archiving hides it from the active list without deleting anything; it is fully reversible.
idrequiredarchivedrequiredDuplicate project
Copy a project (files and settings) into a new project you own, named after the original. Counts against the plan's project quota. Any member with read access may duplicate.
idrequiredGet project files
Get a project's file tree with file contents. Use this to read code before answering questions about it or proposing an update_project change.
idrequiredWrite project files
Create, update or delete files in a project (1–100 per call, each up to 1 MB; paths are relative, no `..`). Other files are left as they are. Overwrites and deletes are applied to the working files immediately — confirm with the user, and use list_checkpoints/restore_checkpoint to undo. Pass `version` (from get_project) to refuse the write if anything changed since you read it. The published site does not change until you deploy again.
idrequiredfilesrequiredversionImport artifact into project
Import a published Misar artifact page into a project as imported/ARTIFACT_ID.html. The url must be exactly https://misar.ai/code/artifact/ARTIFACT_ID; anything else is refused before any fetch.
idrequiredurlrequiredGet project knowledge
Read a project's knowledge — the standing notes (product context, conventions, constraints) the AI builder reads on every change.
idrequiredUpdate project knowledge
Replace a project's knowledge (up to 20,000 characters) — the standing notes the AI builder reads on every change. This replaces the whole text, so read it with get_project_knowledge first and send the edited version.
idrequiredcontentrequiredGet project backend
Show a full-stack project's database backend: whether one is provisioned, its schema name, table count and connection state.
idrequiredProvision project backend
Provision the database backend for a full-stack project: its own isolated schema, protected by row-level security. Safe to repeat — an already-provisioned project reports its existing backend.
idrequiredList templates
List the starter templates a new project can begin from, with their IDs, names and categories. Pick one here before calling use_template.
Takes no parameters.
Get template
Get one template by ID — its description, stack and the files it would create.
idrequiredUse template
Create a new project from a template. Returns the new project; counts against the plan's project quota.
idrequirednamerequiredDeploy project
Publish a project to the public internet on the MisarDev runtime (optionally at a chosen subdomain). The site becomes reachable by anyone. Confirm with the user before calling, check the address first with check_subdomain, and follow with get_deployment_status. Counts against the plan's deploy quota.
idrequiredsubdomainpublic_galleryGet deployment status
Get a project's current deployment: whether it is live, its URL, subdomain and custom-domain state. Call after deploy_project to confirm the site is actually up before telling anyone it is.
idrequiredUnpublish project
Take a published site offline. Its public URL stops serving immediately. This is not a rollback — to go back to an earlier version, restore_checkpoint and deploy again. Confirm with the user first.
idrequiredCheck subdomain
Check whether a subdomain label is free for this project and, if not, get suggestions. The project's own current subdomain reads as available.
idrequiredsubdomainrequiredChange project subdomain
Move a project to a new <subdomain>.misar.app address (check it first with check_subdomain). If the app is published, the live site moves immediately and the OLD address stops working — get the user's explicit approval. If it is not published yet, this just reserves the name for the next deploy.
idrequiredsubdomainrequiredList builds
List your recent AI builds across all projects, newest first, with status, model and the project each belongs to.
limitGet build status
Get whether a project currently has a build running and its latest build state. Poll this rather than assuming a build finished.
idrequiredCancel build
Cancel the build currently running on a project. Work the build had not yet saved is discarded.
idrequiredList checkpoints
List a project's saved checkpoints (up to 100, newest first) with label, changed paths and timestamp. Checkpoints are the project's version history — use one to undo a bad change.
idrequiredRestore checkpoint
Restore a project's files to a checkpoint. The current state is snapshotted first, so the restore itself can be undone — but it does overwrite the working files, so confirm with the user. A published site does not change until you deploy again.
checkpoint_idrequiredRename checkpoint
Give a checkpoint a human-readable label (1–80 characters) so it is easy to find later.
labelrequiredcheckpoint_idrequiredDelete checkpoint
Delete one checkpoint from a project's version history. It can no longer be restored afterwards, and the last remaining checkpoint cannot be deleted. Confirm with the user first.
checkpoint_idrequiredGet custom domain
Get a project's custom domain, its status, the DNS record the user must set, and whether DNS already resolves to the platform (TLS is issued automatically once it does).
idrequiredSet custom domain
Attach a domain the user owns to a published project and provision routing/TLS. Paid plans only (the API answers with an upgrade offer otherwise). Returns the DNS record to set — the domain only serves once that record is live.
idrequireddomainrequiredRemove custom domain
Detach a project's custom domain and remove its route. The domain stops serving the app immediately; the default subdomain keeps working. Confirm with the user first.
idrequiredLook up domain
Look up a domain's public registration data (RDAP): whether it is registered, its registrar and key dates. Useful before suggesting a custom domain.
domainrequiredSearch workspace
Search across your projects and the public catalogue (templates, skills, the published gallery) by name and description. Does NOT search inside project files — use search_project_code for that. A source that could not be reached is reported as unavailable, never as zero results.
limitqueryrequiredtypesWeb search
Answer a question from the live web with citations (MisarDev's grounded search). Returns the answer, url_citation annotations and the ranked sources. Spends model credits; quote only what the sources support.
queryrequiredsearch_context_sizeChat completion
Run a one-shot, non-streaming chat completion on MisarDev's OpenAI-compatible model API. model='misar-online' grounds the answer in the web with citations; omit model for the default coding model. Spends model credits.
modelmessagesrequiredmax_tokenstemperatureIndex project code
Index a project's files for semantic code search (RAG). Pass the files to index as a path → content map; re-indexing a path replaces it. Metered — a paid-plan feature.
filesrequiredproject_idrequiredSearch project code
Semantic search inside an indexed project's code. Answer only from the snippets it returns and cite their file paths; if get_code_index_stats shows nothing indexed, index first.
queryrequiredproject_idrequiredGet code index stats
Get embedding statistics for a project — how many files and chunks are indexed and when.
project_idrequiredClear code index
Delete every embedding for a project. Code search returns nothing until the project is indexed again. Project files are not touched.
project_idrequiredPlan usage and upgrade
Show the current MisarDev plan, how much of each quota (builds, edits, projects) is left this period, and the link to compare plans and upgrade. Call it any time — not only after hitting a limit. Reads only: it never changes the plan or takes payment. On a local install, open=true also opens the pricing page in the user's browser.
openGet usage
Get detailed usage for the account. format=quick returns a lightweight summary, format=dashboard the full dashboard data; analytics=true adds a per-day breakdown over `days` (default 30). For plan limits at a glance, use upgrade.
daysformatanalyticsGet subscription
Get the account's subscription: plan, status, current period end and whether it cancels at period end.
Takes no parameters.
List plans
List MisarDev's plans with prices, limits and features — what each upgrade would unlock.
Takes no parameters.
List notifications
List your notifications (build finished, deploy failed, invitations…), newest first, with the unread count. Pass `before` (an ISO timestamp from the last row) to page back; unread_only=true returns just the count.
beforeunread_onlyMark notifications read
Mark every notification as read, clearing the unread badge. Nothing is deleted.
Takes no parameters.
List API keys
List your API keys — name, prefix, created/expiry dates and IP allowlist. Never returns the secret.
Takes no parameters.
Create API key
Create a new API key. The raw key is returned ONCE — hand it to the user and never repeat or store it. Every MisarDev key has full API access; keys expire (default 90 days, max 365).
namerequiredip_allowlistexpires_in_daysRevoke API key
Revoke an API key by ID. It is deleted permanently and anything still using it fails immediately. Confirm with the user first, and never revoke the key this session is using without saying so.
idrequiredMark one notification read
Mark one notification as read (use mark_notifications_read for all of them).
idrequiredList audit log
List your own audit trail — API-key, deployment and billing events where you were the actor, newest first. Needs a plan that includes audit logs; otherwise it returns an upgrade message.
limitactionoffsetcategoryList connectors
List the connectors available on MisarDev and whether each is enabled for you, with its category, status and dashboard path.
Takes no parameters.
Toggle connector
Enable or disable a connector by slug (from list_connectors). Reversible.
slugrequiredenabledrequired90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a license in the repository or the registry entry.
npx -y @smithery/cli install misar/misardev-mcp --client claudeclaude mcp add misardev -- npx -y @misardev/mcp@latest{ "mcpServers": { "misardev": { "command": "npx", "args": ["-y", "@misardev/mcp@latest"], "env": { "MISARDEV_API_KEY": "mdk_your_key_here" } } }}{ "mcpServers": { "misardev": { "type": "streamable-http", "url": "https://api.misar.io/dev/mcp", "headers": { "Authorization": "Bearer mdk_your_key_here" } } }}