moa-mcp-server
Advanced tools
MCP Server for Memory of Agents (MOA) API - Memory Management & Intelligent Memory endpoints only
Memory of Agents Model Context Protocol Server
A production-ready MCP server that provides access to Memory of Agents (MOA) API for intelligent memory management. This server has been completely cleaned and optimized to include only the memory-management and intelligent-memory endpoints from the official OpenAPI specification.
This MCP server implements 100% coverage of the MOA API endpoints for memory management and intelligent querying. Through comprehensive code cleanup and optimization, it provides:
This repository has been completely cleaned up and made production-ready:
This codebase is now 100% production-ready with complete OpenAPI compliance and comprehensive memory management capabilities.
This server implements 100% coverage of memory-focused endpoints from the MOA API:
✅ POST /api/v1/memory/store → store_memory
✅ POST /api/v1/memory/process/{memory_id} → process_memory
✅ GET /api/v1/memory/list → list_memories
✅ GET /api/v1/memory/stats/overview → get_memory_stats
✅ GET /api/v1/memory/search → search_memories
✅ GET /api/v1/memory/tags → get_memory_tags
✅ GET /api/v1/memory/recent → get_recent_memories
✅ POST /api/v1/memory/bulk-delete → bulk_delete_memories
✅ POST /api/v1/memory/export → export_memories
✅ GET /api/v1/memory/{memory_id} → get_memory
✅ PUT /api/v1/memory/{memory_id} → update_memory
✅ DELETE /api/v1/memory/{memory_id} → delete_memory
✅ GET /api/v1/memory/{memory_id}/status → get_memory_processing_status
✅ POST /api/v1/memory/{memory_id}/reprocess → reprocess_memory
✅ POST /api/v1/memory/query → query_memories
✅ POST /api/v1/memory/batch-query → batch_query_memories
✅ GET /api/v1/memory/suggestions → get_query_suggestions
✅ GET /api/v1/memory/suggestions/analytics → get_suggestions_analytics
✅ GET /api/v1/memory/health → check_memory_health
src/
├── index.ts # Main server with all 19 tools registered
├── services/
│ ├── config.ts # Configuration management
│ └── moa-api.ts # API service with 19 endpoint methods
├── tools/ # 19 production-ready tools
│ ├── Memory Management (14)
│ │ ├── create-memory.ts → Store memories with AI processing
│ │ ├── list-memories.ts → Paginated memory listing
│ │ ├── search-memories.ts → Text search with filtering
│ │ ├── get-memory.ts → Retrieve by ID with details
│ │ ├── update-memory.ts → Update with reprocessing
│ │ ├── delete-memory.ts → Permanent deletion
│ │ ├── get-memory-stats.ts → Statistics and analytics
│ │ ├── bulk-delete-memories.ts → Batch deletion
│ │ ├── get-recent-memories.ts → Recent access history
│ │ ├── get-memory-tags.ts → Unique tag extraction
│ │ ├── process-memory.ts → Manual AI processing
│ │ ├── export-memories.ts → JSON/CSV export
│ │ ├── get-memory-processing-status.ts → Status monitoring
│ │ └── reprocess-memory.ts → Latest model reprocessing
│ └── Intelligent Memory (5)
│ ├── query-memories.ts → AI-powered search
│ ├── batch-query-memories.ts → Efficient batch queries
│ ├── get-query-suggestions.ts → AI suggestions
│ ├── get-suggestions-analytics.ts → System analytics
│ └── check-memory-health.ts → Health monitoring
└── types/
└── index.ts # Complete type definitions and Zod schemas
Important: MCP servers are NOT deployed to remote servers. They run locally alongside AI applications like Claude Desktop, VS Code, or other MCP-compatible clients.
┌─────────────┐ stdio ┌─────────────────┐ HTTPS ┌─────────────┐
│ Claude │ ◄────────► │ MCP Server │ ───────────► │ MOA API │
│ Desktop │ │ (runs locally) │ │ (memof.ai) │
└─────────────┘ └─────────────────┘ └─────────────┘
No server deployment needed - just publish to npm! 📦
npm install -g moa-mcp-server
moa-mcp-server --setup
export MOA_API_KEY="your_api_key_here"
# Start the server
moa-mcp-server
# Show help
moa-mcp-server --help
# Show version
moa-mcp-server --version
# Test connection
moa-mcp-server --test
For Claude Desktop users:
// Add to ~/.config/claude_desktop_config.json
{
"mcpServers": {
"moa": {
"command": "moa-mcp-server",
"env": {
"MOA_API_KEY": "your-moa-api-key-here",
"MOA_BASE_URL": "https://beta-api.memof.ai"
}
}
}
}
For VS Code users:
// Add to VS Code MCP extension settings
{
"mcp.servers": {
"moa": {
"command": "moa-mcp-server",
"env": {
"MOA_API_KEY": "your-moa-api-key-here",
"MOA_BASE_URL": "https://beta-api.memof.ai"
}
}
}
}
After configuration, restart your AI client and you'll have access to all 19 memory management tools!
MOA_API_KEY - Your MOA API key (required)MOA_BASE_URL - MOA API base URL (default: https://beta-api.memof.ai)// Store important information
{
"name": "store_memory",
"arguments": {
"content": "User prefers morning meetings and coffee",
"metadata": {
"source": "conversation",
"priority": "high"
}
}
}
// Find relevant memories with AI understanding
{
"name": "query_memories",
"arguments": {
"query": "What does the user prefer for meetings?",
"search_strategy": "adaptive",
"max_results": 10,
"include_insights": true
}
}
// Get recently accessed memories
{
"name": "get_recent_memories",
"arguments": {
"limit": 5
}
}
// View memory analytics
{
"name": "get_memory_stats",
"arguments": {}
}
The query_memories tool supports multiple search strategies:
This MCP server covers the following MOA API endpoints:
/api/v1/memory/)POST /store - Store MemoryGET /list - List MemoriesGET /search - Search MemoriesGET /{memory_id} - Get MemoryPUT /{memory_id} - Update MemoryDELETE /{memory_id} - Delete MemoryGET /stats/overview - Get Memory StatsPOST /bulk-delete - Bulk Delete MemoriesGET /recent - Get Recent MemoriesGET /tags - Get Memory Tags/api/v1/memory/)POST /query - Universal Memory QueryThe server includes comprehensive error handling:
All errors are returned in a consistent format with helpful error messages.
git clone https://github.com/memof-ai/moa-mcp-server
cd moa-mcp-server
npm install
npm run build
npm test
npm run test:coverage
npm run dev
MIT License - see LICENSE file for details.
FAQs
MCP Server for Memory of Agents (MOA) API - Memory Management & Intelligent Memory endpoints only
The npm package moa-mcp-server receives a total of 13 weekly downloads. As such, moa-mcp-server popularity was classified as not popular.
We found that moa-mcp-server demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Cursor removed a malicious Claude Code 2.1.313 extension from its marketplace. Socket examines registry records and the initial claims about its distribution.
Security News
An OpenCode user faced harassment after reporting a free AI usage loophole, drawing a bitter backlash in a GitHub thread that has since been deleted.
Threat Research
/Security News
319 browser extensions installed by 13.4 million users hijack searches, capture queries, and collect referral payments from Yahoo and Bing.