What can you do with this server?

This server provides configurable full-text search across historical data from multiple domains: agent session logs, meeting transcripts, notification files, command history, and runtime logs. Capabilities include: * Search across one or all domains with options for FST-accelerated or regex search, date range filtering, role filtering (for sessions: user/assistant/tool), speaker filtering (for transcripts), case sensitivity, context lines, and result limits. * List available files and their metadata within a domain, with optional date filtering and entry limits. * Read specific entries from a file or directory, with role/speaker filtering and latest-first ordering. * Summarize entries in sessions or transcripts using AI-generated summaries. * Rebuild FST indexes for fast search across configured domains. * Search command history with plain text or regex, case sensitivity, and limits. * Search runtime logs with query, regex, case sensitivity, and optional log level filtering (e.g., WARNING, ERROR, DEBUG, INFO).

How do I use Unified History MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Unified History MCP search all history for 'deployment failure'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Unified History MCP

by jmars

Overview Schema Related Servers Score Discussions

Python

Local

Unified History MCP

Config-driven MCP server for cross-domain full-text search across agent session logs, meeting transcripts, and notification files.

Quick Start

# Install from source (PyPI package coming soon)
pip install git+https://github.com/jmars/unified-history-mcp.git

# Create a config file at ~/.config/unified-history-mcp/config.toml
# or use the example as a starting point:
cp config.example.toml ~/.config/unified-history-mcp/config.toml

# Start the server
unified-history-mcp

Add to your MCP client configuration:

{
  "mcpServers": {
    "unified-history": {
      "command": "unified-history-mcp"
    }
  }
}

Related MCP server: docsearch

Configuration

Configuration is loaded from the first existing location:

$UNIFIED_HISTORY_CONFIG environment variable
~/.config/unified-history-mcp/config.toml
./unified-history.toml (current working directory)

Domain Configuration

Each [domains.X] section defines a searchable domain:

Field	Type	Default	Description
`dir`	string	required	Root directory for this domain's files
`pattern`	string	`"*"`	Glob pattern for file discovery
`type`	string	`"files"`	`"files"` or `"dirs"`
`extensions`	string[]	`[]`	Allowed extensions (e.g. `[".txt", ".docx"]`)
`extractor`	string	`"jsonl"`	Extractor: `jsonl`, `txt`, `transcript`, `notification`
`renderer`	string	(extractor)	Renderer override
`label`	string	`"file"`	Human label: "session", "transcript", etc.
`fst_binary`	string	`"fst-indexer"`	Path or name of the FST indexer binary
`fst_index_dir`	string	(dir)	Override for index directory
`date_field`	string	—	JSON field for date extraction (jsonl only)
`filters`	string[]	`[]`	Supported filters: `role`, `speaker`

Global Configuration

Section	Field	Description
`[history]`	`file`	Path to command history file
`[log]`	`file`	Path to runtime log file

MCP Tools

`search(domain, query, ...)`

Full-text search with FST fast path and regex fallback.

Parameter	Type	Default	Description
`domain`	string	`"all"`	Domain or `"all"` for cross-domain
`query`	string	`""`	Search text or regex pattern
`max_results`	int	`20`	Maximum total matches
`date_from`	string	—	Start date (YYYY-MM-DD)
`date_to`	string	—	End date (YYYY-MM-DD, inclusive)
`regex`	bool	`false`	Treat query as regex
`context_lines`	int	`2`	Surrounding context lines per match
`case_sensitive`	bool	`false`	Case-sensitive matching
`max_matches_per_file`	int	`5`	Max matches from any single file
`role`	string	—	[sessions] Filter by role: user, assistant, tool
`speaker`	string	—	[transcripts] Filter by speaker name

`list_domain(domain, date_from, date_to, max_results)`

List available files in a domain with metadata.

Parameter	Type	Default	Description
`domain`	string	—	Domain to list
`date_from`	string	—	Start date (YYYY-MM-DD)
`date_to`	string	—	End date (YYYY-MM-DD, inclusive)
`max_results`	int	`50`	Maximum entries to show

`read(domain, id, max_entries, role, speaker)`

Read entries from a domain file.

Parameter	Type	Default	Description
`domain`	string	—	Domain
`id`	string	—	File/directory name or unique prefix
`max_entries`	int	`50`	Maximum entries (newest first)
`role`	string	—	[sessions] Filter by role
`speaker`	string	—	[transcripts] Filter by speaker name

`summary(domain, id)`

Get the AI-generated summary for a domain entry.

Parameter	Type	Description
`domain`	string	Domain (sessions, transcripts)
`id`	string	File/directory name or unique prefix

`rebuild(domain)`

Rebuild FST indexes for configured domains.

Parameter	Type	Default	Description
`domain`	string	`"all"`	Domain or `"all"` for all

`search_history(query, max_results, regex, case_sensitive)`

Search the command history file.

Parameter	Type	Default	Description
`query`	string	—	Search text or regex pattern
`max_results`	int	`30`	Maximum matches
`regex`	bool	`false`	Treat query as regex
`case_sensitive`	bool	`false`	Case-sensitive matching

`search_log(query, max_results, regex, case_sensitive, level)`

Search the runtime log file.

Parameter	Type	Default	Description
`query`	string	—	Search text or regex pattern
`max_results`	int	`30`	Maximum matches
`regex`	bool	`false`	Treat query as regex
`case_sensitive`	bool	`false`	Case-sensitive matching
`level`	string	—	Filter by log level

How It Works

Configuration — TOML file defines domains, their directories, extractors, and renderers.
Domain Discovery — Files are discovered via glob patterns with extension filtering.
Fast Path (FST) — If the optional fst-indexer binary is installed and indexes are built (via the rebuild tool), searches use the blazing-fast FST index.
Slow Path (Regex) — Falls back to line-by-line regex scanning across files when FST is unavailable.
Extractors — Produce text entries for FST indexing from different file formats (JSONL, TXT, Tactiq transcripts, notifications).
Renderers — Format entries for human-readable display in search results, listings, and read output.

Development

git clone https://github.com/jmars/unified-history-mcp.git
cd unified-history-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines on setting up the dev environment, running tests, and submitting pull requests.

License

MIT — see LICENSE.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

ElasticMind-MCP
Databases Search RAG Systems
ViratGarg2
F
license
A
quality
D
maintenance
An MCP server that indexes PDF documentation and text into Elasticsearch for semantic search and retrieval. It enables users to query knowledge bases, ingest new files, and dynamically update content through MCP-compatible clients like Claude Desktop and Cursor.
Last updated 2025-12-13
4
1
docsearch
Search Documentation Access
AllenComm
A
license
A
quality
D
maintenance
MCP server that enables searching and reading binary document files (PDF, DOCX, PPTX, XLSX, ODT, ODS, ODP, RTF, EPUB) using regex patterns and retrieving content by sections.
Last updated 2026-06-15
2
MIT
LogicNotes MCP Server
Note Taking Search Text Summarization
sharveen22
A
license
-
quality
C
maintenance
Read-only MCP server for searching and retrieving LogicNotes meeting notes, including summaries, transcripts, and action items.
Last updated 2026-06-26
MIT
docsonar
ribhav-jain
A
license
-
quality
B
maintenance
A local document search MCP server that indexes folders and provides hybrid keyword+semantic search, enabling users to chat with their documents via MCP clients like Claude Desktop or Claude Code.
Last updated 2026-07-20
MIT

View all related MCP servers

Related MCP Connectors

qsearch
Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.
saagarpatel.dev Portfolio
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Dewey
Agentic search over your Dewey document collections from any MCP-compatible client.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jmars/unified-history-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Unified History MCP

Quick Start

Configuration

Domain Configuration

Global Configuration

MCP Tools

search(domain, query, ...)

list_domain(domain, date_from, date_to, max_results)

read(domain, id, max_entries, role, speaker)

summary(domain, id)

rebuild(domain)

search_history(query, max_results, regex, case_sensitive)

search_log(query, max_results, regex, case_sensitive, level)

How It Works

Development

Contributing

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

ElasticMind-MCP

docsearch

LogicNotes MCP Server

docsonar

Related MCP Connectors

Latest Blog Posts

MCP directory API

`search(domain, query, ...)`

`list_domain(domain, date_from, date_to, max_results)`

`read(domain, id, max_entries, role, speaker)`

`summary(domain, id)`

`rebuild(domain)`

`search_history(query, max_results, regex, case_sensitive)`

`search_log(query, max_results, regex, case_sensitive, level)`