API overview

Base URL: https://answers.bootstrapware.co. Success responses are { "data": ... }. Errors are { "error": { "code", "message" } }. Health is GET /api/health.

Publishable ask

POST /api/v1/ask?appId=ana_… with Authorization: Bearer and a publishable key. Body: { "sessionId", "question", "pageContext?" }. pageContext is url and title only. Question max is 1,000 characters. The body cap is 8,192 bytes. The response is one complete result: answered with citations, or unanswered with fallback.

There is no GET /api/v1/config/:appId route and no public feedback route. The React package does not call ask unless you pass an adapter. See AGENTS.md.

Script

GET /embed/v1.js serves the versioned widget. It is the same component as the React package.

Provider (secret)

GET, PUT, and DELETE /api/v1/apps/:id/provider use a secret key. PUT accepts only { "apiKey" } and returns that key once. Later GET returns a hint. This is not an MCP tool.

MCP

POST https://answers.bootstrapware.co/mcp. Prefer OAuth scope answers:mcp. A test secret is the fallback. Tools configure apps and public URL sources. They do not accept questions, file bytes, or provider keys.

• list_answers_apps
• get_answers_app
• create_answers_app
• update_answers_draft
• publish_answers_app
• get_answers_published_config
• get_answers_install_snippet
• ensure_answers_test_publishable
• list_answers_capabilities
• add_answers_url_source
• reindex_answers_app

App create, draft, and publish are MCP tools. They are not a separate secret REST collection in this release. File upload, manual answers, conversations, unanswered text, export, and purge stay on the dashboard.

Related: API keys · Knowledge sources · Cursor guide