MCP Tools

Overview

The Trix MCP server exposes several tools that AI assistants can use to manage memories. These tools are automatically available to any MCP-compatible client once configured.

Tool Categories

• Memory Tools - Store, recall, list, and manage memories
• Audio Tools - Transcribe, search, and analyze audio/video content
• Topic Tools - Work with LLM-extracted topics
• Cluster Tools - Organize memories into semantic groups
• Enrichment Tools - Add LLM-generated metadata to memories

store_memory

Store a new memory in Trix. Use this tool to save important information for later recall.

Parameters

Example

// Tool: store_memory
// Parameters:
{
  "content": "The user prefers dark mode in all applications",
  "tags": ["preference", "ui"],
  "metadata": {
    "source": "conversation",
    "confidence": 0.95
  }
}

// Returns:
{
  "id": "mem_abc123",
  "content": "The user prefers dark mode in all applications",
  "created_at": "2024-01-15T10:30:00Z"
}

Example Prompts

• "Remember that I prefer TypeScript over JavaScript"
• "Save this: my favorite color is blue"
• "Store this information for later: meeting with John at 3pm tomorrow"

search_memories

Search for relevant memories using semantic similarity. This tool finds memories that are conceptually related to your query, even if they don't contain the exact words.

Parameters

Example

// Tool: search_memories
// Parameters:
{
  "query": "What are the user's UI preferences?",
  "limit": 5,
  "threshold": 0.7
}

// Returns:
{
  "memories": [
    {
      "id": "mem_abc123",
      "content": "The user prefers dark mode in all applications",
      "similarity": 0.92,
      "tags": ["preference", "ui"]
    }
  ]
}

delete_memory

Delete a specific memory. Use this when information is no longer relevant or was stored incorrectly.

Parameters

Example

// Tool: delete_memory
// Parameters:
{
  "id": "mem_abc123"
}

// Returns:
{
  "success": true,
  "deleted_id": "mem_abc123"
}

Memory Management Tools

Tools for managing memory lifecycle, including pinning, protection, and soft deletion.

pin_memory

Pin a memory to prevent it from decaying over time. Pinned memories maintain their priority and are always included in relevant search results.

unpin_memory

Unpin a previously pinned memory, allowing it to decay naturally.

protect_memory

Set the protection level for a memory to prevent accidental deletion.

soft_delete_memory

Soft delete a memory, allowing it to be restored later. Soft-deleted memories are hidden from normal queries but can be recovered.

restore_memory

Restore a soft-deleted memory, making it visible and searchable again.

Topic Tools

Tools for working with LLM-extracted topics from memories.

get_memory_topics

Get the topics extracted from a memory. Topics are automatically categorized and scored for relevance.

search_by_topic

Find memories that are related to a specific topic.

Cluster Tools

Tools for working with automatically generated memory clusters.

list_clusters

List clusters at a specific scale. Clusters group related memories together.

get_cluster_details

Get details about a specific cluster, optionally including its member memories.

Clustering Tools

Tools for triggering cluster generation to organize memories.

trigger_clustering

Trigger cluster generation for memories. This organizes memories into semantic groups at different scales (fine, medium, coarse) for better discovery.

Enrichment Tools

Tools for enriching memories with LLM-generated metadata.

enrich_memory

Enrich a memory with LLM-generated metadata including topics, summaries, entities, and quality scores.

Audio Tools

Tools for working with audio and video content, including transcription, search, and segment extraction.

list_audio_files

List audio files with optional filters.

get_audio_transcript

Get the full transcript for an audio file. Optionally include detailed segment information and speaker identification.

search_audio_transcripts

Search within audio transcripts using semantic search. Returns matches with timestamps, speaker information, and clip URLs for precise navigation.

get_audio_segments

Get transcript segments with timestamps and speaker information.

trigger_transcription

Start a transcription job for an audio or video file.

semantic_search (Enhanced)

The semantic_search tool has been enhanced to search across both memories and audio transcripts.

Parameters

Updated Tool Parameters

Several existing tools have been enhanced with new parameters for pinning, protection, quality filtering, and cluster awareness.

store_memory (Updated)

The store_memory tool now accepts additional parameters for memory management:

search_memories (Updated)

The search_memories tool now supports additional filtering options:

list_memories (Updated)

The list_memories tool now supports additional filtering options:

Next Steps

• Advanced - Troubleshooting and advanced configuration
• Daemon - Run Trix as a background service