MisarDev MCP Server

The 54 tools it listed

"Read only" and "Changes data" are the server's own marks. Underlined parameters are required.

1. archive_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.

   id archived

2. cancel_buildChanges data

   Cancel the build currently running on a project. Work the build had not yet saved is discarded.

   id

3. check_subdomainRead only

   Check whether a subdomain label is free for this project and, if not, get suggestions. The project's own current subdomain reads as available.

   id subdomain

4. clear_code_indexChanges data

   Delete every embedding for a project. Code search returns nothing until the project is indexed again. Project files are not touched.

   project_id

5. 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).

   name expires_in_days ip_allowlist

6. create_chat_completionRead only

   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.

   messages model temperature max_tokens

7. create_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.

   name description files settings

8. delete_checkpointChanges data

   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_id

9. delete_projectChanges data

   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.

   id

10. deploy_projectChanges data

    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.

    id subdomain public_gallery

11. duplicate_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.

    id

12. get_build_statusRead only

    Get whether a project currently has a build running and its latest build state. Poll this rather than assuming a build finished.

    id

13. get_code_index_statsRead only

    Get embedding statistics for a project — how many files and chunks are indexed and when.

    project_id

14. get_custom_domainRead only

    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).

    id

15. get_deployment_statusRead only

    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.

    id

16. get_projectRead only

    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.

    id

17. get_project_backendRead only

    Show a full-stack project's database backend: whether one is provisioned, its schema name, table count and connection state.

    id

18. get_project_filesRead only

    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.

    id

19. get_project_knowledgeRead only

    Read a project's knowledge — the standing notes (product context, conventions, constraints) the AI builder reads on every change.

    id

20. get_subscriptionRead only

    Get the account's subscription: plan, status, current period end and whether it cancels at period end.

21. get_templateRead only

    Get one template by ID — its description, stack and the files it would create.

    id

22. get_usageRead only

    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.

    format analytics days

23. import_artifact

    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.

    id url

24. index_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.

    project_id files

25. list_api_keysRead only

    List your API keys — name, prefix, created/expiry dates and IP allowlist. Never returns the secret.

26. list_audit_logRead only

    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.

    limit offset category action

27. list_buildsRead only

    List your recent AI builds across all projects, newest first, with status, model and the project each belongs to.

    limit

28. list_checkpointsRead only

    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.

    id

29. list_connectorsRead only

    List the connectors available on MisarDev and whether each is enabled for you, with its category, status and dashboard path.

30. list_notificationsRead only

    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.

    before unread_only

31. list_plansRead only

    List MisarDev's plans with prices, limits and features — what each upgrade would unlock.

32. list_projectsRead only

    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.

    limit cursor view

33. list_templatesRead only

    List the starter templates a new project can begin from, with their IDs, names and categories. Pick one here before calling use_template.

34. lookup_domainRead only

    Look up a domain's public registration data (RDAP): whether it is registered, its registrar and key dates. Useful before suggesting a custom domain.

    domain

35. mark_notification_read

    Mark one notification as read (use mark_notifications_read for all of them).

    id

36. mark_notifications_read

    Mark every notification as read, clearing the unread badge. Nothing is deleted.

37. provision_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.

    id

38. remove_custom_domainChanges data

    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.

    id

39. rename_checkpoint

    Give a checkpoint a human-readable label (1–80 characters) so it is easy to find later.

    checkpoint_id label

40. restore_checkpointChanges data

    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_id

41. restore_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.

    id

42. revoke_api_keyChanges data

    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.

    id

43. search_project_codeRead only

    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.

    project_id query

44. search_workspaceRead only

    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.

    query limit types

45. set_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.

    id domain

46. toggle_connector

    Enable or disable a connector by slug (from list_connectors). Reversible.

    slug enabled

47. unpublish_projectChanges data

    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.

    id

48. update_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).

    id name description files settings is_public version

49. update_project_knowledgeChanges data

    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.

    id content

50. update_project_subdomainChanges data

    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.

    id subdomain

51. upgradeRead only

    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.

    open

52. use_template

    Create a new project from a template. Returns the new project; counts against the plan's project quota.

    id name

53. web_searchRead only

    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.

    query search_context_size

54. write_project_filesChanges data

    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.

    id files version