Features/MCP Server

Your AI remembers

The MCP server lets AI agents search your past sessions and read project context during conversations. One command to install.

mcp install
$ sfs mcp install --for claude-code
MCP server configured for Claude Code.
Restart Claude Code to activate.
145 tools available to your AI agent:
Session tools (10):
• search_sessions — Search past sessions
• get_session_context — Full conversation from a session
• list_recent_sessions — Browse recent work
• find_related_sessions — Find by file or error
• get_session_summary — Structured session summary
• get_audit_report — Trust audit report
• get_session_provenance — Which rules instructed a session
• ask_session_helper — Ask the helper over sessions you can read
• get_session_retrieval_log — What an agent retrieved during a session
• rename_session — Rename a session or set its alias
Knowledge read (9):
• get_project_context — Full wiki: overview + pages + concepts
• get_context_section — One section of the context doc
• get_wiki_page — One wiki page in full
• get_wiki_page_history — Revision history with persona / ticket attribution
• search_project_knowledge — Search knowledge entries
• list_knowledge_entries — Filter by type / class / freshness
• get_knowledge_entry — One entry's full record
• get_knowledge_health — Pending / compiled counts
• ask_project — Q&A with sources_cited
Knowledge write (8):
• add_knowledge — Save a discovery / decision / pattern
• update_wiki_page — Create or update a wiki page
• list_wiki_pages — Browse wiki structure
• compile_knowledge_base — Trigger a compile pass
• dismiss_knowledge_entry — Dismiss a stale or wrong entry (audited)
• update_entry_confidence — Raise or lower an entry's confidence
• promote_entry — Promote a note to a claim
• promote_eligible_entries — Promote every eligible note at once
Rules (2):
• get_rules — Canonical project rules
• get_compiled_rules — Compiled rules per tool
Personas (7):
• list_personas — Project personas
• get_persona — One persona's full content
• create_persona — Define a new project persona
• update_persona — Edit a persona
• delete_persona — Retire a persona
• assume_persona — Tag captured sessions with this persona
• forget_persona — Clear the active persona bundle
Tickets (16) — every plan:
• list_tickets — Filter by status / assignee
• get_ticket — Ticket detail + dependencies
• create_ticket — Open new ticket (acceptance criteria required for agents)
• update_ticket — Edit a ticket (diff comment + audit)
• approve_ticket — Approve a suggested ticket
• start_ticket — Atomic claim + compiled context + bundle write
• complete_ticket — Send to review, clear owned bundle
• resolve_ticket — Mark done from review
• assign_persona — Set the persona on a ticket
• escalate_ticket — Audit comment + raise priority
• add_ticket_comment — Slack-like thread
• list_ticket_comments — Page through a ticket's comments
• get_ticket_review_state — Open findings + last review verdict
• check_merge_readiness — Is the work safe to merge at this commit?
• watch_ticket — Follow a ticket to be told when it changes
• get_ticket_updates — Poll what changed on followed tickets
Agent runs (6) — every plan:
• create_agent_run — Track a persona run, manual or CI
• complete_agent_run — Record findings, evaluate fail-on policy
• replay_agent_run — Re-run with an edited prompt or context
• list_agent_runs — Browse runs by persona / status / ticket
• report_agent_run_usage — Add tokens and cost to a run in flight
• get_spend_summary — Agent spend by persona, model, ticket, role or day
Agent feedback (3) — every plan:
• record_agent_feedback — Record how an agent run or ticket turned out
• list_agent_feedback — Browse feedback records
• get_agent_feedback_summary — Counts by type and verdict
Handoffs (8) — Pro+:
• create_handoff — Hand work to a teammate or team
• claim_handoff — Claim a handoff with its ticket and context
• get_handoff — One handoff in full
• list_inbox_handoffs — Handoffs sent to you
• list_sent_handoffs — Handoffs you sent
• revoke_handoff — Withdraw a handoff
• decline_handoff — Decline a handoff
• add_handoff_comment — Comment on a handoff
Checkpoints (3):
• checkpoint_session — Snapshot a session
• list_checkpoints — A session's checkpoints
• fork_session — Branch a new session from a checkpoint
Work queues (6):
• create_work_queue — Aim an agent at a queue of tickets
• get_work_queue — Queue config + progress
• list_work_queues — Browse a project's queues
• set_work_queue_status — Pause / resume / archive
• run_work_queue_step — Heartbeat: one bounded directive per wake
• complete_work_queue_step — Durably advance the queue
Skills marketplace (10):
• search_skill_marketplace — Search skill and plugin packages
• get_marketplace_package — Hash, license, risk, compatibility and install disclosure
• diff_marketplace_versions — What changed between two versions (text, code or widening)
• preview_marketplace_skill — Untrusted instruction preview
• load_marketplace_skill — Load an approved instruction-only skill
• request_skill_install — Ask a project admin to approve an install
• get_skill_install_request — One install request
• list_skill_install_requests — Project install requests
• cancel_skill_install_request — Cancel a pending request
• get_skill_policy — Your org's skills policy, per tool
Project groups (15):
• search_group_knowledge — Search claims across a group's projects you can read
• get_group_context — The group's compiled overview
• ask_group — Research a question across a group, with sources
• update_project_group — Rename a group or turn its knowledge compile on
… plus list, create, delete, add/remove projects, members, grant/revoke access, compile
Meetings (7):
• upload_meeting_transcript — Store a transcript
• list_meeting_transcripts — Meetings, newest first
• get_meeting_transcript — One meeting in full
• extract_meeting_action_items — Action items, decisions, participants
• promote_meeting_action_item — Preview or create a ticket
• link_meeting_action_item — Preview or link an existing ticket
• search_meetings — Search transcripts
External contacts (4):
• list_external_contacts — People you work with who aren’t SessionFS users
• get_external_contact — One contact and where they appear
• create_external_contact — Add a contact
• update_external_contact — Edit a contact or its other names
Evaluations and lineage (10) — Team+ for writes:
• start_eval_run — Start grading a suite against an artifact or commit
• record_eval_results — Post per-case results; the server computes the verdict
• compare_eval_runs — Regressions, fixes and score changes
• register_artifact — A dataset, model or prompt version, as a pointer
• get_artifact_lineage — What it came from and what came from it
… plus list/get suites, get a run, link and list artifacts
Review loops (6) — Team+:
• start_review_loop — Start a loop on a ticket or a new one
• get_loop_status — Children, rounds, spend and budget
• update_review_loop — Raise or clear a limit
• get_loop_report — Per-round findings and cost
• get_loop_checklist — The project checklist
• propose_checklist_item — Propose a checklist item
Approvals (3) — Enterprise, read only:
• list_my_approvals — Requests waiting on you
• get_approval_request — One request with every decision
• list_approval_policies — Your org's approval policies

What the MCP server gives you

One-command install

Works with Claude Code, Cursor, and Copilot. Adds SessionFS to your tool's MCP config file automatically — no manual JSON editing.

Project context

Share architecture decisions, coding conventions, and API contracts with every AI agent on your team. One document per repo, always current.

Local, No Network Needed

Local MCP server on stdio for desktop tools — no network required.

How agents use session memory

When you start a new session, your AI agent can automatically search for related past sessions and load their context — so it already knows what you tried last time.

The find_related_sessions tool maps file paths and error strings to previous sessions. If you're debugging the same file you touched last week, the agent knows.

Read the MCP docs
agent using MCP
Agent calls MCP tool
find_related_sessions("tokens.py")
SessionFS returns
ses_abc — Debug auth middleware (2 days ago)
ses_d2e — JWT token refresh fix (5 days ago)
Agent says
"I found 2 related sessions. The last time you worked on tokens.py, you extended the expiry window and added redis for caching..."