memcp.xyz

General

Code Editors

{
  "mcpServers": {
    "memcp": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"],
      "env": {
        "FETCH_URL": "https://memcp.xyz/api/mcp",
        "FETCH_HEADERS": "{\"Authorization\": \"Bearer YOUR_API_KEY\"}"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "memcp": {
        "url": "https://memcp.xyz/api/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "memcp": {
      "url": "https://memcp.xyz/api/mcp",
      "apiKey": "YOUR_API_KEY"
    }
  }
}

Core Concepts

Understanding the fundamental building blocks of memcp.

Context

Optional metadata field that provides additional context for a memory. Use it to store related information like source, date, or background details that complement the main content.

Content: "User prefers dark mode themes"
Context: "From UI/UX feedback session on 2024-01-15"
Tags: #preferences #ui #feedback

Content

The main text of your memory. This is the primary information you want to store and retrieve. Content can be up to 10,000 tokens (approximately 40KB of text).

Memories

Individual items that store your information. Each memory has content, optional context, and tags. Memories are searchable and can be organized using tags.

Tags

Labels that organize and categorize your memories. Tags are powerful because they support boolean filtering (AND/OR/NOT operations) and can be combined for precise searches.

Tag examples: #work #personal #urgent #project-alpha #ideas #reference

Boolean Tag Filtering

Combine tags with logical operators for precise filtering:

• work AND urgent - Memories with both tags
• work OR personal - Memories with either tag
• work AND NOT archived - Work memories that aren't archived
• (work OR personal) AND urgent - Urgent memories from work or personal

Fuzzy Search

memcp uses trigram-based fuzzy search to find memories even with typos or partial matches. Search for "dark mode" and it will find "darkmode", "dark theme", and similar variations.

Recommended System Prompts

Add these prompts to your AI system instructions to enable optimal memory usage.

General Memory Usage

You have access to a memory system through memcp. Use it to:
1. Store important user preferences, decisions, and context
2. Search for relevant past information before making recommendations
3. Update memories when user preferences change
4. Create memories with descriptive tags for easy retrieval

When to create memories:
- User expresses preferences or requirements
- Important decisions are made
- Context that might be needed later
- Project-specific information

When to search memories:
- Before making recommendations
- When user references past conversations
- To maintain consistency across sessions
- To recall user preferences and context

In general, first look up the available tags for an understanding of what is in the memory system.
Then to search for memories, search by tag or keyword.
To add memories, try to keep the content as short as possible.
Always use the pre-existing tags that are already in the system.

Best Practices

MCP Tools Documentation

Complete reference for all available memcp MCP tools.

search_memories

Search memories with fuzzy matching and tag filters

search_memories({
  query: "dark mode preferences",
  tagFilter: "work AND NOT archived"
})

create_memory

Create a new memory with tags

create_memory({
  content: "User prefers dark mode themes",
  context: "From UI/UX feedback session",
  tags: ["preferences", "ui", "dark-mode"]
})

update_memory

Update an existing memory

update_memory({
  memoryId: "abc123",
  content: "Updated: User prefers dark mode with high contrast",
  tags: ["preferences", "ui", "dark-mode", "accessibility"]
})

delete_memory

Delete a memory by ID

delete_memory({
  memoryId: "abc123"
})

list_tags

List all tags with usage counts

list_tags()
// Returns: [{name: "work", count: 15}, {name: "personal", count: 8}, ...]

Authentication

All MCP requests must include authentication:

Authorization: Bearer YOUR_API_KEY

The API key automatically identifies your user account and provides access to your memories only.

Power User Features

Unlock the full potential of memcp with these advanced capabilities.

Boolean Tag Filtering Syntax

Combine tags with logical operators for precise filtering:

# Basic AND
work AND urgent

# Basic OR  
work OR personal

# NOT operator
work AND NOT archived

# Complex expressions
(work OR personal) AND urgent
(project-alpha OR project-beta) AND NOT completed

# Multiple conditions
work AND urgent AND NOT (archived OR completed)

Fuzzy Search Capabilities

memcp uses SQLite FTS5 with trigram indexing for powerful fuzzy matching:

• Handles typos and misspellings automatically
• Matches partial words and substrings
• Supports phrase matching with quotes
• Combines with tag filters for precision
• Fast performance even with large datasets

# These searches will find related results:
"dark mode" → "darkmode", "dark theme", "dark-mode"
"performanc" → "performance", "performing", "performant"
"data base" → "database", "data-base"

Bulk Operations and Efficiency

Tips for managing large numbers of memories efficiently:

• Use descriptive tags to avoid duplicate content
• Combine related information into single memories with good context
• Regularly archive old memories with status tags
• Use consistent naming conventions for tags
• Leverage boolean filters to batch-process similar memories

Common Issues and Solutions

Resolve common problems and get answers to frequently asked questions.

Integration Issues

Authentication Problems

Performance and Limits

General FAQ

Data Protection and Privacy

How memcp protects your data and ensures privacy.

Data Isolation

Your memories are completely isolated and private:

• No memory sharing between users under any circumstances
• API keys provide access only to your own memories
• Database queries are scoped to your user ID automatically
• Even administrators cannot access other users' memories

Security Considerations

Important security notes:

• All API requests require valid authentication
• HTTPS enforced for all communications
• Rate limiting prevents abuse and attacks
• Input validation prevents injection attacks
• Regular security audits and updates

How memcp Compares to Other Memory Platforms

Simple answers to help you understand memcp's unique approach.

Q: How does memcp.xyz compare to mem0, Supermemory, and Letta?

A: memcp.xyz is focused on being incredibly simple and easy to use. Most tools on the market are for developers, seeking to build memory systems within their own AI applications and products. memcp.xyz is intended for regular users of AI tools with a fast and powerful Web-UI and integrate easily with a hosted MCP server.