{"openapi":"3.1.0","info":{"title":"Mnemonicbuilder API","version":"0.1.0","description":"A fully local mnemonic-device generator: an acronym/acrostic generator that processes your supplied item list, a method-of-loci (memory palace) guide, a rhyme/rhythm mnemonic reference, and a technique recommender.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://mnemonicbuilder.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/mnemonicbuilder/docs"},"termsOfService":"https://connectorbay.com/mnemonicbuilder/terms"},"servers":[{"url":"https://mnemonicbuilder.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/mnemonicbuilder/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/acronym_acrostic_generator":{"post":{"operationId":"acronym_acrostic_generator","summary":"Extracts the first letter of each supplied item and either finds a matching real English word (a true","description":"Extracts the first letter of each supplied item and either finds a matching real English word (a true\n    acronym) or generates a memorable acrostic sentence (one word per letter). Genuinely processes the specific\n    items given, not a template. Use for \"make an acronym/acrostic out of these items\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"items":{"description":"The list of items to memorize, in order.","items":{"type":"string"},"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"acronym_acrostic_generatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/method_of_loci_guide":{"post":{"operationId":"method_of_loci_guide","summary":"Explains the method-of-loci (memory palace) technique with a full worked example; if you pass your own","description":"Explains the method-of-loci (memory palace) technique with a full worked example; if you pass your own\n    items, tailors it by assigning each one to a stop along a default sample route in order. Use for \"explain\n    the memory palace technique\", \"help me build a memory palace for this list\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"items":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional: your own item list, tailored onto a sample route in order.","title":"Items"}},"title":"method_of_loci_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/rhyme_mnemonic_reference":{"post":{"operationId":"rhyme_mnemonic_reference","summary":"A hand-curated reference of well-known rhyme/rhythm mnemonics by category (spelling, math, calendar,","description":"A hand-curated reference of well-known rhyme/rhythm mnemonics by category (spelling, math, calendar,\n    science, geography). Use for \"what's the mnemonic for order of operations\", \"rhyme for days in each month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"spelling | math | calendar | science | geography","title":"Category","type":"string"}},"required":["category"],"title":"rhyme_mnemonic_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/recommend_mnemonic_technique":{"post":{"operationId":"recommend_mnemonic_technique","summary":"Recommends whether an acronym/acrostic or a method-of-loci route fits a given item list better, based on","description":"Recommends whether an acronym/acrostic or a method-of-loci route fits a given item list better, based on\n    the ~7-item working-memory chunk limit. Use for \"what's the best way to memorize this list\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"items":{"description":"The list of items to memorize, in order.","items":{"type":"string"},"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"recommend_mnemonic_techniqueArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}