IDE Configuration (Cursor / Windsurf / Claude Desktop)
JSON
{
"mcpServers": {
"piyapi": {
"command": "npx",
"args": ["-y", "@piyapi/mcp-server"],
"env": {
"PIYAPI_API_KEY": "sk_live_your_key_here"
}
}
}
}
Core Tools Catalog (from User Guide §6.2)
| TOOL NAME | INPUT PARAMETERS | DESCRIPTION |
|---|---|---|
| store_memory | content (str), tags (array), metadata (obj) | Store memory with vector embedding and graph links |
| get_memory | id (uuid) | Retrieve specific memory object by UUID |
| search_memories | query (str), limit (int), min_score (float) | Hybrid search (semantic vector + BM25 trigram) |
| get_context | query (str), max_tokens (int) | Token-budget-aware context assembly for prompt injection |
| pin_memory | id (uuid), is_pinned (bool) | Pin/unpin memory in LLM context window budget |