MCP Tools Reference

Detailed documentation for each tool available on the Audaxic MCP server.

---

add_memory

Store a new memory for the authenticated user.

Parameters

Parameter	Type	Required	Description
text	string	Yes	The memory content to store
metadata	Record<string, string>	No	Optional key-value metadata

Example

Tool: add_memory
Arguments:
  text: "User prefers dark mode and uses VS Code"
  metadata:
    source: "conversation"

Response

{
  "content": [
    {
      "type": "text",
      "text": "{\"results\": [{\"id\": \"mem_abc123\", \"memory\": \"User prefers dark mode and uses VS Code\", \"metadata\": {\"source\": \"conversation\"}}]}"
    }
  ]
}

---

search_memories

Semantic vector search across stored memories.

Parameters

Parameter	Type	Required	Description
query	string	Yes	The search query in natural language
limit	number	No	Maximum number of results (default: 10)

Example

Tool: search_memories
Arguments:
  query: "What editor does the user prefer?"
  limit: 5

Response

{
  "content": [
    {
      "type": "text",
      "text": "{\"results\": [{\"id\": \"mem_abc123\", \"memory\": \"User prefers dark mode and uses VS Code\", \"metadata\": {}}]}"
    }
  ]
}

---

get_memories

List all stored memories for the authenticated user.

Parameters

Parameter	Type	Required	Description
limit	number	No	Maximum number of results (default: 100)

Example

Tool: get_memories
Arguments:
  limit: 50

Response

{
  "content": [
    {
      "type": "text",
      "text": "{\"memories\": [{\"id\": \"mem_abc123\", \"memory\": \"User prefers dark mode\", \"metadata\": {}}]}"
    }
  ]
}

---

delete_memory

Delete specific memories by their IDs.

Parameters

Parameter	Type	Required	Description
memory_ids	string[]	Yes	List of memory IDs to delete

Example

Tool: delete_memory
Arguments:
  memory_ids: ["mem_abc123", "mem_def456"]

Response

{
  "content": [
    {
      "type": "text",
      "text": "{\"success\": true}"
    }
  ]
}

---

delete_all_memories

Delete all memories for the project associated with the authenticated user. Use with caution.

Parameters

None.

Example

Tool: delete_all_memories
Arguments: (none)

Response

{
  "content": [
    {
      "type": "text",
      "text": "{\"success\": true, \"deleted_count\": 42}"
    }
  ]
}

---

Error Responses

All tools return errors in the standard MCP error format:

{
  "content": [
    {
      "type": "text",
      "text": "Engine error 401: {\"error\": \"Invalid API key\"}"
    }
  ],
  "isError": true
}

Common errors:

Error	Meaning
Invalid API key	Missing or invalid authentication
Rate limit exceeded	Too many requests (1,200/hour limit)
No containers available	Service temporarily unavailable