{"openapi":"3.1.0","info":{"title":"Moves public API","version":"1.0.0","summary":"Public guides, Markdown pages, and the Moves MCP server.","description":"Moves is a social life app that helps people spend time together. These endpoints let an agent read Moves' public guides and pages. With the user's OAuth consent, an assistant can use the MCP server to read and share moves, manage connections and crews, and handle invites.","contact":{"name":"Moves","email":"davidhanlon23@gmail.com","url":"https://www.whatsthemove.social/contact"},"termsOfService":"https://www.whatsthemove.social/terms"},"servers":[{"url":"https://www.whatsthemove.social","description":"Moves website and public guides"}],"externalDocs":{"description":"Assistant guides","url":"https://www.whatsthemove.social/docs"},"tags":[{"name":"Docs","description":"Public guides for connecting an assistant."},{"name":"Content","description":"Site pages as Markdown for agents."},{"name":"Assistant","description":"The MCP server for signed-in users."}],"paths":{"/api/search":{"get":{"operationId":"searchDocs","tags":["Docs"],"summary":"Search the public Moves guides","description":"Full-text search over the public assistant guides. Returns matching pages, headings, and passages in relevance order. An empty or missing query returns an empty list.","parameters":[{"name":"query","in":"query","required":true,"description":"Words to search for, such as a tool name or permission.","schema":{"type":"string","minLength":1,"examples":["connection invites"]}},{"name":"limit","in":"query","required":false,"description":"Maximum number of results to return.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Matching results, best first.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}}}}},"405":{"description":"The endpoint only accepts GET.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/llms.mdx/{slug}":{"get":{"operationId":"getDocsPageMarkdown","tags":["Docs"],"summary":"Get a public guide as Markdown","description":"Returns one public assistant guide as Markdown. /llms.mdx without a slug returns the guides overview.","parameters":[{"name":"slug","in":"path","required":true,"description":"The guide's slug, as listed in /llms.txt.","schema":{"type":"string","enum":["mcp","permissions","tools","troubleshooting","when-to-use"]}}],"responses":{"200":{"description":"The guide as Markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"No guide has this slug.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsIndex","tags":["Content"],"summary":"Get the llms.txt index","description":"An llms.txt index of public Moves pages and guides, with guidance on when an assistant should use Moves.","responses":{"200":{"description":"The index as Markdown text.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/index.md":{"get":{"operationId":"getHomeMarkdown","tags":["Content"],"summary":"Get the Moves home page as Markdown","description":"What Moves is, how it works, and how to request an invite. The same content is served at / when a request sends Accept: text/markdown.","responses":{"200":{"description":"The page as Markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/about.md":{"get":{"operationId":"getAboutMarkdown","tags":["Content"],"summary":"Get the About page as Markdown","description":"Why Moves exists, its principles, and its current availability.","responses":{"200":{"description":"The page as Markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/contact.md":{"get":{"operationId":"getContactMarkdown","tags":["Content"],"summary":"Get the Contact page as Markdown","description":"How to reach Moves about invites, support, privacy requests, and assistant connections.","responses":{"200":{"description":"The page as Markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/mcp":{"servers":[{"url":"https://app.whatsthemove.social","description":"Moves product app"}],"post":{"operationId":"callMcp","tags":["Assistant"],"summary":"Send a Model Context Protocol request","description":"The Moves MCP server (Streamable HTTP). Send JSON-RPC 2.0 messages such as initialize, tools/list, and tools/call with an OAuth access token the user approved. Prefer an MCP client over calling this directly; see /docs/mcp and /docs/tools.","security":[{"mcpOAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"A JSON-RPC response, or an event stream of responses.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}},"text/event-stream":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}},"401":{"description":"Missing or invalid access token. The WWW-Authenticate header names the protected-resource metadata to start OAuth."},"403":{"description":"The token lacks the scope this tool requires."},"429":{"description":"Too many requests. Retry after the Retry-After delay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}},"503":{"description":"Assistant connections are temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable error code."},"message":{"type":"string","description":"What went wrong."},"hint":{"type":"string","description":"How to fix the request."},"documentation":{"type":"string","format":"uri"}}}}},"AppError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong."}}},"SearchResult":{"type":"object","required":["id","url","type","content"],"properties":{"id":{"type":"string"},"url":{"type":"string","description":"Root-relative URL of the match."},"type":{"type":"string","enum":["page","heading","text"]},"content":{"type":"string","description":"Matched text, with <mark> highlights."},"breadcrumbs":{"type":"array","items":{"type":"string"}}}},"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","integer"]},"method":{"type":"string","examples":["tools/list","tools/call"]},"params":{"type":"object"}}},"JsonRpcResponse":{"type":"object","required":["jsonrpc"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","integer","null"]},"result":{"type":"object"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{}}}}}},"securitySchemes":{"mcpOAuth":{"type":"oauth2","description":"OAuth 2.1 with PKCE. Discover the server at https://app.whatsthemove.social/.well-known/oauth-protected-resource.","flows":{"authorizationCode":{"authorizationUrl":"https://app.whatsthemove.social/connect/authorize","tokenUrl":"https://app.whatsthemove.social/oauth/token","refreshUrl":"https://app.whatsthemove.social/oauth/token","scopes":{"moves:read":"Read your moves and moves shared with you","moves:write":"Share, change, and end moves; show or withdraw interest","connections:read":"Read your friends and connection requests","connections:write":"Add and remove connections, including friendship access","activity:read":"Read incoming adds and private interest in your moves","crews:read":"Read your private crews and their members","crews:write":"Create, change, and delete your private crews","invites:read":"Read connection invites and their applicants","invites:write":"Create, accept, approve, cancel, and revoke connection invites","context:read":"Read the screen you choose to share","profile:read":"Read your profile settings","profile:write":"Create, change, and delete your profile settings","feedback:read":"Read your feedback","feedback:write":"Send, change, and delete your feedback"}}}}}}}