---
title: BEMA developer portal
description: Integrate with BEMA through REST, NLWeb, and separate product and documentation MCP servers.
canonical: https://bema.jpamorgan.com/developers
last-updated: 2026-08-22
---

# BEMA developer portal

BEMA provides a public, read-only interface to the complete BEMA Podcast catalog and its available transcript corpus. Integrations can discover structured episodes, search transcript text, and retrieve complete stored transcripts through REST. The MCP tools expose the same discovery workflow, but `get_transcript` is deliberately bounded and can return a truncated transcript.

## Quickstart

No signup or API key is needed. The service is free. Send HTTPS requests to `https://api.bema.jpamorgan.com` and accept JSON.

```sh
curl --get 'https://api.bema.jpamorgan.com/v1/episodes' \
  --data-urlencode 'q=Sabbath' \
  --data-urlencode 'limit=5'
```

```sh
curl --get 'https://api.bema.jpamorgan.com/v1/transcripts/search' \
  --data-urlencode 'q=kingdom of God' \
  --data-urlencode 'limit=10'
```

```sh
curl 'https://api.bema.jpamorgan.com/v1/transcripts/42'
```

The transcript route returns `404` when BEMA has no local transcript for the requested slug. Treat that as an expected availability result and use the episode's catalog metadata and source links as the fallback.

## Contracts and discovery

- [OpenAPI JSON](https://api.bema.jpamorgan.com/openapi.json) is the exact REST contract.
- [API guide](https://bema.jpamorgan.com/api.md) explains endpoints, parameters, caching, and errors.
- [Authentication guide](https://bema.jpamorgan.com/auth.md) distinguishes public content from the protected agent-session demonstration.
- [Product MCP endpoint](https://api.bema.jpamorgan.com/mcp) uses Streamable HTTP for episode and transcript tools.
- [Documentation MCP endpoint](https://api.bema.jpamorgan.com/mcp/docs) is a separate Streamable HTTP documentation surface.
- [MCP discovery index](https://bema.jpamorgan.com/.well-known/mcp/index.json) links both identities and server cards.
- [NLWeb ask endpoint](https://api.bema.jpamorgan.com/ask) supports documented JSON and SSE discovery.
- [Batch endpoint](https://api.bema.jpamorgan.com/v1/batch) groups a bounded number of supported read operations.
- [Sandbox guidance](https://api.bema.jpamorgan.com/sandbox) documents safe test calls.
- [Agent Skills index](https://bema.jpamorgan.com/.well-known/agent-skills/index.json) maps common jobs to invocations.
- [Agent instructions](https://bema.jpamorgan.com/agents.md) explain when BEMA is the right tool.
- [Pricing](https://bema.jpamorgan.com/pricing) confirms that public access is free.
- [Canonical source repository](https://github.com/jpamorgan/BEMA) is private and requires repository access; deployed discovery manifests remain public on this domain.

## Sandbox

The public catalog and transcript routes are safe for narrow production read tests; use small `limit` values. The dedicated `/sandbox` surface documents supported examples. The protected agent-session demonstration does create bounded state and is not covered by the no-state claim.

The interactive [BEMA episode explorer](https://bema.jpamorgan.com/episodes) is the human-facing companion for validating search results and handing an episode back to a user.