MisarDev MCP Server

它列出的 54 个工具

“只读”和“会改数据”是服务方自己标的。带下划线的参数是必填的。

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_build会改数据

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

   id

3. check_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.

   id subdomain

4. clear_code_index会改数据

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

   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_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_id

9. delete_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.

   id

10. deploy_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.

    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_status只读

    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_stats只读

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

    project_id

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

    id

15. get_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.

    id

16. get_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.

    id

17. get_project_backend只读

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

    id

18. get_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.

    id

19. get_project_knowledge只读

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

    id

20. get_subscription只读

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

21. get_template只读

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

    id

22. get_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.

    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_keys只读

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

26. list_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.

    limit offset category action

27. list_builds只读

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

    limit

28. list_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.

    id

29. list_connectors只读

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

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

    before unread_only

31. list_plans只读

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

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

    limit cursor view

33. list_templates只读

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

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

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

    id

43. search_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.

    project_id query

44. search_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.

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

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

    id content

50. update_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.

    id subdomain

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

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

    query search_context_size

54. write_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.

    id files version