Brainfish website screenshot

Brainfish

Brainfish is an AI product-support platform for B2B SaaS companies, built in Sydney and deployed globally with US/EU/AU data residency. Its AI support agents resolve customer tickets across chat, email, in-product, Slack and Teams, grounding every answer in the company's real product knowledge rather than training on customer data. Brainfish exposes a REST Public API (https://api.brainfi.sh) to programmatically manage the knowledge base (collections, documents, catalogs), generate cited AI answers and follow-up questions, and pull session analytics, plus a remote Model Context Protocol (MCP) server and an embeddable browser widget suite. Backed by Prosus Ventures.

Brainfish publishes 9 APIs on the APIs.io network, including Agents API, Analytics API, Authentication API, and 6 more. Tagged areas include Company, AI, Customer Support, Knowledge Base, and Help Desk.

Brainfish’s developer surface includes documentation, API reference, getting-started guide, support, changelog, engineering blog, pricing, and 18 more developer resources.

🌐 Visit website 📡 Source on GitHub
57.7/100 developing ▬ flat Agent 59/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
9 APIs 1 MCP Servers
CompanyAICustomer SupportKnowledge BaseHelp DeskAgentsSupport AutomationSaaS

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 57.7/100 · developing
Contract Quality 15.5 / 25
Developer Ergonomics 12.6 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 7.5 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 59/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 12 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/brainfish: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

Brainfish Agents API

AI agent operations for answer generation and streaming

Brainfish Analytics API

Conversation thread analytics with filtering and pagination

Brainfish Authentication API

Authentication and token validation operations

Brainfish Catalogs API

Catalog management operations. Create catalogs and sync content programmatically via the API.

Brainfish Collections API

Collection management operations including create, read, update, list, and delete

Brainfish Conversations API

Conversation operations including follow-up question generation

Brainfish Documents API

Document management operations including create, read, update, list, and delete

Brainfish Sessions API

Chat session search, detail, timeline, and AI-powered insights. A "session" is a chat conversation keyed by conversationId.

Brainfish Users API

User-scoped operations. Generate answers personalized to a specific external/platform user with automatic attribute-based collection filtering.

Scroll for all 9

Arazzo Workflows 4

Multi-step API workflows described with the Arazzo specification.

_Index

ARAZZO

Generate an answer and follow-up questions

Generate a cited AI answer for an end-user question, then generate suggested follow-up questions.

ARAZZO

Create and sync an API catalog

Create a catalog, sync content into it, then read back its status.

ARAZZO

Create a collection and add a document

Validate the token, create a knowledge-base collection, then create a document inside it.

ARAZZO

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

brainfish-mcp.yml

MCP SERVER

Rate Limits 1

Documented rate limits and quota policies.

Brainfish Rate Limits

2 limits

RATE LIMITS

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Brainfish Authentication

apiKey/http · 3 schemes

SECURITY

Brainfish Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Brainfish Trust Center

SOC 2, ISO 27001

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Brainfish Agentic Access

27 operations · 19 acting · 1 human-in-the-loop

27 operations · 19 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 AgentSkill
AgentSkill
 WellKnown
WellKnown
 LLMsTxt
LLMsTxt

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Components
Components
 Lifecycle
Lifecycle

Build 3

SDKs, sample code, and the tooling you integrate with

Packages
Packages
 SDKs
SDKs
 GitHubOrganization
GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 Compliance
Compliance
 DomainSecurity
DomainSecurity

Operate 3

Status, limits, changes, and where to get help

Support
Support
 ChangeLog
ChangeLog
 StatusPage
StatusPage

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Blog
Blog
 Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: brainfish
name: Brainfish
description: Brainfish is an AI product-support platform for B2B SaaS companies, built in Sydney and deployed globally with
  US/EU/AU data residency. Its AI support agents resolve customer tickets across chat, email, in-product, Slack and Teams,
  grounding every answer in the company's real product knowledge rather than training on customer data. Brainfish exposes
  a REST Public API (https://api.brainfi.sh) to programmatically manage the knowledge base (collections, documents, catalogs),
  generate cited AI answers and follow-up questions, and pull session analytics, plus a remote Model Context Protocol (MCP)
  server and an embeddable browser widget suite. Backed by Prosus Ventures.
url: https://raw.githubusercontent.com/api-evangelist/brainfish/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- prosus-ventures
x-tier: profiled
x-tier-reason: enriched-from-public-api
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-18'
image: https://www.brainfishai.com/og-default.png
tags:
- Company
- AI
- Customer Support
- Knowledge Base
- Help Desk
- Agents
- Support Automation
- SaaS
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- aid: brainfish:brainfish-agents-api
  name: Brainfish Agents API
  description: AI agent operations for answer generation and streaming
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Agents
  properties:
  - type: OpenAPI
    url: openapi/brainfish-agents-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-analytics-api
  name: Brainfish Analytics API
  description: Conversation thread analytics with filtering and pagination
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Analytics
  properties:
  - type: OpenAPI
    url: openapi/brainfish-analytics-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-authentication-api
  name: Brainfish Authentication API
  description: Authentication and token validation operations
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/brainfish-authentication-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-catalogs-api
  name: Brainfish Catalogs API
  description: Catalog management operations. Create catalogs and sync content programmatically via the API.
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Catalogs
  properties:
  - type: OpenAPI
    url: openapi/brainfish-catalogs-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-collections-api
  name: Brainfish Collections API
  description: Collection management operations including create, read, update, list, and delete
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Collections
  properties:
  - type: OpenAPI
    url: openapi/brainfish-collections-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-conversations-api
  name: Brainfish Conversations API
  description: Conversation operations including follow-up question generation
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Conversations
  properties:
  - type: OpenAPI
    url: openapi/brainfish-conversations-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-documents-api
  name: Brainfish Documents API
  description: Document management operations including create, read, update, list, and delete
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Documents
  properties:
  - type: OpenAPI
    url: openapi/brainfish-documents-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-sessions-api
  name: Brainfish Sessions API
  description: Chat session search, detail, timeline, and AI-powered insights. A "session" is a chat conversation keyed by
    conversationId.
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Sessions
  properties:
  - type: OpenAPI
    url: openapi/brainfish-sessions-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
- aid: brainfish:brainfish-users-api
  name: Brainfish Users API
  description: User-scoped operations. Generate answers personalized to a specific external/platform user with automatic attribute-based
    collection filtering.
  humanURL: https://docs.brainfi.sh/api-reference
  baseURL: https://api.brainfi.sh
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/brainfish-users-api-openapi.yml
  - type: APIReference
    url: https://docs.brainfi.sh/api-reference
  - type: Authentication
    url: authentication/brainfish-authentication.yml
  - type: Conventions
    url: conventions/brainfish-conventions.yml
  - type: Idempotency
    url: conventions/brainfish-conventions.yml
  - type: ErrorCatalog
    url: errors/brainfish-problem-types.yml
  - type: RateLimits
    url: rate-limits/brainfish-rate-limits.yml
  - type: DataModel
    url: data-model/brainfish-data-model.yml
  - type: AgenticAccess
    url: agentic-access/brainfish-agentic-access.yml
  - type: Conformance
    url: conformance/brainfish-conformance.yml
  - type: Arazzo
    url: arazzo/brainfish-create-collection-and-document.yml
  - type: Arazzo
    url: arazzo/brainfish-answer-and-followups.yml
  - type: Arazzo
    url: arazzo/brainfish-catalog-sync.yml
common:
- type: DeveloperPortal
  url: https://docs.brainfi.sh
- type: Documentation
  url: https://docs.brainfi.sh
- type: APIReference
  url: https://docs.brainfi.sh/api-reference
- type: GettingStarted
  url: https://help.brainfi.sh
- type: Support
  url: https://help.brainfi.sh
- type: MCPServer
  url: mcp/brainfish-mcp.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Packages
  url: packages/brainfish-packages.yml
- type: SDKs
  url: packages/brainfish-packages.yml
- type: Components
  url: components/brainfish-components.yml
- type: WellKnown
  url: well-known/brainfish-well-known.yml
- type: LLMsTxt
  url: llms/brainfish-llms.txt
- type: ChangeLog
  url: changelog/brainfish-changelog.yml
- type: Lifecycle
  url: lifecycle/brainfish-lifecycle.yml
- type: StatusPage
  url: https://status.brainfi.sh
- type: TrustCenter
  url: security/brainfish-trust-center.yml
- type: Compliance
  url: https://trust.brainfi.sh/
- type: DomainSecurity
  url: security/brainfish-domain-security.yml
- type: GitHubOrganization
  url: https://github.com/brainfish-ai
- type: Blog
  url: https://www.brainfishai.com/blog
- type: Pricing
  url: https://www.brainfishai.com/pricing
- type: SignUp
  url: https://app.brainfi.sh
- type: TermsOfService
  url: https://www.brainfishai.com/terms
- type: PrivacyPolicy
  url: https://www.brainfishai.com/privacy-policy
- type: Website
  url: https://www.brainfishai.com
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence