---
type: "post"
id: "atuin-making-your-shell-magical-analysis-203c2e"
slug: "atuin-making-your-shell-magical-analysis-203c2e"
title: "Atuin adds MCP tools to list, read and search shell-history sessions"
description: "Atuin’s repository has added MCP operations for listing, reading, and richer search across sessions."
retrieval_nugget: "Atuin’s repository has added MCP operations for listing, reading, and richer search across sessions."
published_at: "2026-09-29"
updated_at: "2026-09-29"
record_date: "2026-09-29"
date_kind: "published_at"
topics: ["mcp"]
source_urls: ["https://github.com/atuinsh/atuin"]
schema_version: "newruntime-agent-readable-v0.2"
stable_id: "post:atuin-making-your-shell-magical-analysis-203c2e"
status: "published"
visuals: []
editorial_provenance: {"schema_version":"newruntime-editorial-copy-v1","content_status":"source_grounded_final","final_copy_sha256":"sha256:05ea24f0d494c9f330abe4e9ef8ec7bbc8a11cd68604e4e96d334483a808ea20","reviewed_at":"2026-09-29T14:05:44.081Z","source_evidence_count":1,"verified_claim_count":3,"site_analysis_schema_version":"newruntime-site-analysis-v1","site_object_kind":"field_note","observed_fact_count":3,"implication_count":2,"watch_condition_count":2,"related_record_count":0}
analysis: {"schema_version":"newruntime-site-analysis-v1","object_kind":"field_note","thesis":"This update makes shell-session history more accessible to agent-oriented tooling, without demonstrating autonomous operation.","observed_facts":[{"text":"The repository’s latest commit is titled “feat(ai): list, read and richer search MCP tools for sessions.”","source_urls":["https://github.com/atuinsh/atuin"]},{"text":"Atuin’s repository describes stored command context including exit status, duration, timestamp, hostname, and working directory.","source_urls":["https://github.com/atuinsh/atuin"]},{"text":"The repository describes encrypted synchronization of history between machines.","source_urls":["https://github.com/atuinsh/atuin"]}],"mechanism":"Atuin exposes additional MCP tools over session history, alongside its existing history-search and storage model.","why_now":"The repository’s latest commit surfaces the session tools as a current project change, making the interface expansion concrete rather than merely hypothetical.","implications":["MCP clients may be able to query and inspect more of a user’s shell-session history through a standardized tool interface.","That could reduce friction when an agent needs prior command context, but the repository excerpt does not show an agent successfully using it."],"evidence_boundary":"The supplied public repository excerpt verifies the commit title and Atuin’s described storage and history features, but it does not specify permission controls, deployment defaults, actual adoption, or measured agent performance.","watch_conditions":["Check the implementation and documentation for permission boundaries and the session data exposed by each MCP tool.","Further evidence about access controls, filtering, and real-world use would determine whether this is a meaningful operational integration or primarily a new interface."],"related_records":[],"new_branch_reason":"No prior New Runtime record is supplied for this specific repository change; the new MCP session tools warrant a distinct analytical record."}
editor: {"role":"editor","name":"Andrey Reshetnikov","profile":"https://newruntime.com/owner-profile.md","profile_json":"https://newruntime.com/owner-profile.json","same_as":["https://www.linkedin.com/in/reshetnikov1/","https://t.me/lapetuse"]}
routes: {"html":"https://newruntime.com/posts/atuin-making-your-shell-magical-analysis-203c2e/","markdown":"https://newruntime.com/posts/atuin-making-your-shell-magical-analysis-203c2e.md","json":"https://newruntime.com/posts/atuin-making-your-shell-magical-analysis-203c2e.json"}
---

# Atuin adds MCP tools to list, read and search shell-history sessions

## Retrieval answer

Atuin’s repository has added MCP operations for listing, reading, and richer search across sessions.

Atuin’s repository has added MCP operations for listing, reading, and richer search across sessions. **Thesis:** This update makes shell-session history more accessible to agent-oriented tooling, without demonstrating autonomous operation. The repository identifies the change in a recent commit titled “feat(ai): list, read and richer search MCP tools for sessions.” **Mechanism:** Atuin exposes additional MCP tools over session history, alongside its existing history-search and storage model. Its documented records include exit status, duration, timestamp, hostname, and working directory.

**Why now:** The repository’s latest commit surfaces the session tools as a current project change, making the interface expansion concrete rather than merely hypothetical. The project already describes encrypted synchronization between machines, so the new operations sit on top of a history system designed to retain contextual records. **First implication:** MCP clients may be able to query and inspect more of a user’s shell-session history through a standardized tool interface. That could reduce friction when an agent needs prior command context, but the repository excerpt does not show an agent successfully using it.

**Evidence boundary:** The supplied public repository excerpt verifies the commit title and Atuin’s described storage and history features, but it does not specify permission controls, deployment defaults, actual adoption, or measured agent performance. The commit alone cannot establish that agents can safely or reliably use the data. **First watch condition:** Check the implementation and documentation for permission boundaries and the session data exposed by each MCP tool. Further evidence about access controls, filtering, and real-world use would determine whether this is a meaningful operational integration or primarily a new interface.

Editor: [Andrey Reshetnikov](https://newruntime.com/owner-profile.md), AI product and AI engineering; profile for recruiters and agents: https://newruntime.com/owner-profile.json

## Continue in the graph

Next records for an agent, linked to their Markdown twins. Replace `.md` with `.json` for structured fields, including `next_reads`.

- topic hub: [Mcp](https://newruntime.com/topics/mcp.md): Explore the mcp topic hub.
- collection: [Field Notes](https://newruntime.com/posts.json): Open the latest editorial analysis.
- collection: [Source Ledger](https://newruntime.com/source-ledger.json): Inspect the public source evidence graph.
- whole graph: [discovery graph](https://newruntime.com/discovery-graph.json) (typed nodes and edges) and [site index](https://newruntime.com/site-index.md)