{"openapi":"3.1.0","info":{"title":"memory-mcp","description":"Persistent memory for AI agents, paid per call via x402 (USDC, Base mainnet) — your wallet is your private, semantically-indexed memory namespace. Write $0.001, search $0.002, export $0.01; free trial + $2/30d unlimited subscription. MCP + HTTP. No account, no API key.","contact":{"name":"Boris Inc","url":"https://borisinc.com/","email":"donk.boris@mailfence.com"},"version":"1.0.0"},"paths":{"/paid/memory/write":{"get":{"summary":"Http Write","operationId":"http_write_paid_memory_write_get","parameters":[{"name":"content","in":"query","required":true,"schema":{"type":"string","title":"Content"}},{"name":"tags","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tags"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"integer","title":"Agent Id"}},{"name":"on_behalf","in":"query","required":false,"schema":{"type":"string","default":"","title":"On Behalf"}},{"name":"grant","in":"query","required":false,"schema":{"type":"string","default":"","title":"Grant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/paid/memory/search":{"get":{"summary":"Http Search","operationId":"http_search_paid_memory_search_get","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"K"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"integer","title":"Agent Id"}},{"name":"on_behalf","in":"query","required":false,"schema":{"type":"string","default":"","title":"On Behalf"}},{"name":"grant","in":"query","required":false,"schema":{"type":"string","default":"","title":"Grant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/paid/memory/export":{"get":{"summary":"Http Export","operationId":"http_export_paid_memory_export_get","parameters":[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"integer","title":"Agent Id"}},{"name":"on_behalf","in":"query","required":false,"schema":{"type":"string","default":"","title":"On Behalf"}},{"name":"grant","in":"query","required":false,"schema":{"type":"string","default":"","title":"Grant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/paid/memory/forget":{"get":{"summary":"Http Forget","operationId":"http_forget_paid_memory_forget_get","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","title":"Ids"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"integer","title":"Agent Id"}},{"name":"on_behalf","in":"query","required":false,"schema":{"type":"string","default":"","title":"On Behalf"}},{"name":"grant","in":"query","required":false,"schema":{"type":"string","default":"","title":"Grant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/paid/memory/import":{"get":{"summary":"Http Import","operationId":"http_import_paid_memory_import_get","parameters":[{"name":"memories","in":"query","required":true,"schema":{"type":"string","title":"Memories"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"integer","title":"Agent Id"}},{"name":"on_behalf","in":"query","required":false,"schema":{"type":"string","default":"","title":"On Behalf"}},{"name":"grant","in":"query","required":false,"schema":{"type":"string","default":"","title":"Grant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/memory/stats":{"get":{"summary":"Http Stats","operationId":"http_stats_memory_stats_get","parameters":[{"name":"namespace","in":"query","required":true,"schema":{"type":"string","title":"Namespace"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/llms.txt":{"get":{"summary":"Llms","operationId":"llms_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[]}},"/.well-known/agent-card.json":{"get":{"summary":"Agent Card","description":"Agent card — how a buying agent learns what this sells and what it costs.\n\nAdded 2026-07-26: the borisinc.com surface audit found mem.borisinc.com had\nneither an agent card nor /.well-known/x402, so an agent discovering it by\nthe conventional well-known paths learned nothing about a service that sells.\nEvery skill states the free/paid pairing explicitly.","operationId":"agent_card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/x402":{"get":{"summary":"Wk X402","description":"Machine-readable list of payable resources — what an x402 buyer parses first.","operationId":"wk_x402__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/x402-resources":{"get":{"summary":"Wk X402","description":"Machine-readable list of payable resources — what an x402 buyer parses first.","operationId":"wk_x402__well_known_x402_resources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/x402-resources":{"get":{"summary":"Wk X402","description":"Machine-readable list of payable resources — what an x402 buyer parses first.","operationId":"wk_x402_x402_resources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/agent-registration.json":{"get":{"summary":"Agent Registration Json","description":"ERC-8004 registration file (spec registration-v1).","operationId":"agent_registration_json__well_known_agent_registration_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/subscribe":{"get":{"summary":"Subscribe","description":"PAID $2.00: 30 days of unlimited write/search/export for the paying wallet's namespace.\nReturns a bearer token (Authorization: Bearer mem_...).","operationId":"subscribe_subscribe_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/trial/memory/write":{"get":{"summary":"Trial Write","operationId":"trial_write_trial_memory_write_get","parameters":[{"name":"content","in":"query","required":true,"schema":{"type":"string","title":"Content"}},{"name":"tags","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tags"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/trial/memory/search":{"get":{"summary":"Trial Search","operationId":"trial_search_trial_memory_search_get","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"K"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/free/memory/write":{"get":{"summary":"Free Write","operationId":"free_write_free_memory_write_get","parameters":[{"name":"content","in":"query","required":true,"schema":{"type":"string","title":"Content"}},{"name":"tags","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tags"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/free/memory/search":{"get":{"summary":"Free Search","operationId":"free_search_free_memory_search_get","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"K"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/grant/payload":{"get":{"summary":"Grant Payload","operationId":"grant_payload_grant_payload_get","parameters":[{"name":"namespace","in":"query","required":true,"schema":{"type":"string","title":"Namespace"}},{"name":"grantee","in":"query","required":true,"schema":{"type":"string","title":"Grantee"}},{"name":"mode","in":"query","required":false,"schema":{"type":"string","default":"read","title":"Mode"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}