---
title: "Open Media developer portal"
description: "Quickstart for building on Open Media: no-key public API, personal access tokens, MCP servers, plugins and the test-mode sandbox."
canonical: https://convo-mail-sync.convo-mail-sync.workers.dev/developers
last-updated: 2026-10-27
---

# Open Media developer portal

Build on Open Media without an account for public data, or act for a person with their own token.

## Quickstart

1. Read the public feed: `curl "https://convo-mail-sync.convo-mail-sync.workers.dev/v1/feed"`. No key, no signup.
2. Connect an MCP client to `https://convo-mail-sync.convo-mail-sync.workers.dev/open/mcp` (Streamable HTTP).
3. To act for a person, sign them in: `POST https://convo-mail-sync.convo-mail-sync.workers.dev/v1/auth/email-code` with their email, ask them for the code Open Media emails them, then `POST https://convo-mail-sync.convo-mail-sync.workers.dev/v1/auth/verify` returns their access token ([details](https://convo-mail-sync.convo-mail-sync.workers.dev/auth.md)). Send it as `Authorization: Bearer <token>`.
4. Install the Open Media plugin for Claude Code or Codex from the [repository](https://github.com/mihirkavi/open-media/tree/main/agent-plugin).
5. For your agent's own rate limit, register it: `POST https://convo-mail-sync.convo-mail-sync.workers.dev/agent/identity` with `{"type": "anonymous"}`, then trade the assertion at `/oauth/token` ([how](https://convo-mail-sync.convo-mail-sync.workers.dev/auth.md)).

## SDKs and command line

The repository includes a TypeScript SDK (`packages/sdk`, `open-media-sdk`), a command line (`packages/cli`, `open-media`) and a Python client (`packages/python`, `open-media`). They are not on npm or PyPI yet; build them from the [repository](https://github.com/mihirkavi/open-media/tree/main/packages). Each retries 429s after `Retry-After` and sends an `Idempotency-Key` on every write.

```ts
import { OpenMedia } from 'open-media-sdk';
const feed = await new OpenMedia().feed({ sources: ['farcaster', 'lens'] });
```

The command line covers the whole platform: every tool on the MCP servers is a command, with flags generated from its input schema and read live from `tools/list`, so new tools appear without an update.

```bash
open-media login              # in the browser
open-media tools --search post
open-media get-feed --sources lens
open-media publish-post "Hi" --yes
open-media api GET /v1/me/follows
source <(open-media completion zsh)
```

`open-media login` registers the CLI as the public OAuth client “Open Media CLI” and listens on a random `127.0.0.1` port for the redirect, so it shows in Sign-in and security → Connected apps and `open-media logout` revokes it. On a machine without a browser, `open-media login you@example.com` signs in with an emailed code. Every tool that changes something asks first (or takes `--yes`); `--json` prints JSON; exit codes are 0 done, 1 the API refused, 2 the command was wrong.

## Access tokens

There are no API keys to request and no sales process. Public data is free and keyless; account access uses the person's own token, so an integration can never do more than that person can. Tokens expire after about an hour.

## Commerce on ONDC (India)

Open Media is building an ONDC seller app (Beckn, retail 1.2.0), described at [https://convo-mail-sync.convo-mail-sync.workers.dev/ondc](https://convo-mail-sync.convo-mail-sync.workers.dev/ondc). Sellers in India set up their store with `GET`/`PUT https://convo-mail-sync.convo-mail-sync.workers.dev/v1/me/ondc` or the `get_ondc_store` and `set_ondc_store` tools on `/me/mcp`. Their public INR products are then offered to ONDC buyer apps through signed `search` and `select` callbacks. Open Media is not yet registered on the ONDC network, and orders through ONDC come in a later phase.

## Sandbox and test mode

- Payments are in test mode (Stripe test cards, USDC on Base Sepolia) until live payments are approved; no real money moves.
- Run the whole stack locally with `npm run local` (database, auth, API and web app) for a private sandbox with test accounts.

## Resources

- [API documentation](https://convo-mail-sync.convo-mail-sync.workers.dev/docs) and [OpenAPI 3.1](https://convo-mail-sync.convo-mail-sync.workers.dev/v1/openapi.json)
- [Agent guide](https://convo-mail-sync.convo-mail-sync.workers.dev/agents) and [authentication](https://convo-mail-sync.convo-mail-sync.workers.dev/auth.md)
- [Skills index](https://convo-mail-sync.convo-mail-sync.workers.dev/.well-known/agent-skills/index.json) and [MCP server card](https://convo-mail-sync.convo-mail-sync.workers.dev/.well-known/mcp/server-card.json)
- [Source code (MIT)](https://github.com/mihirkavi/open-media)
