Back to MCP docs

MCP usage examples

End-to-end scenarios for reviewers and integrators. Connect first at /install, then try these prompts in Claude or Cursor.

1. Save a preference

Example prompt

Remember that I prefer TypeScript and short, practical answers.

Tool

remember

Verify

In a new chat, ask: "What are my coding preferences?" — the AI should call recall and return your saved preference.

2. Project-scoped memory

Example prompt

Remember in collection project:my-app that we use Next.js, Supabase, and MCP Streamable HTTP.

Tool

remember (with collection=project:my-app)

Verify

Ask: "What is the stack for my-app?" — use get_context or recall with collection=project:my-app.

3. Cross-client recall

Example prompt

Save a fact in Claude, then open Cursor with the same Memxus account (same API key or OAuth).

Tool

remember → recall / get_context

Verify

Ask Cursor: "What did I save about this project?" — same memory should appear without re-pasting context.

4. List and browse

Example prompt

List my recent memories (limit 5).

Tool

list_memories

Verify

Returns your latest memories with types, tags, and collections.

5. Delete a memory

Example prompt

Delete memory ID <uuid-from-list_memories>.

Tool

forget

Verify

memory_stats and recall should no longer include that entry.

6. Update a memory

Example prompt

Update memory <uuid> — change the content to "Prefers Vitest over Jest" and add tag testing.

Tool

update

Verify

Call get_memory with the same ID — content and tags should reflect the update without creating a duplicate.

7. Connect a source (optional v2)

Example prompt

Connect my GitHub account so Memxus can sync repository READMEs.

Tool

connect_source → check_connect_status → set_sync_selection

Verify

Requires ENABLE_INAPP_CONNECT on the server and in-app connect enabled in Settings. After OAuth, check_connect_status should report connected; list_syncable_items then set_sync_selection syncs content into memories.