---
title: "Open Media for AI agents"
description: "When an AI agent should use Open Media and exactly how to call it: MCP, REST, WebMCP and skills."
canonical: https://convo-mail-sync.convo-mail-sync.workers.dev/agents
last-updated: 2026-10-27
---

# Open Media for AI agents

Use this page to decide whether Open Media fits a task and how to call it.

## When to use Open Media

- **Cross-network social search.** "What are people saying about Ethereum on Lens this week?" Use the `search` tool or `GET /v1/search?q=`.
- **One feed across open networks.** Summaries of Farcaster, Lens, Hive, DeSo and Open Media posts, each with its source link and "why" reasons. Use `get_feed`.
- **A person's posts everywhere.** One timeline for an Open Media handle plus the accounts they listed. Use `get_person_timeline`.
- **A feed the person describes.** "Only videos about cooking, no crypto": write a feed lens with `draft_feed_lens`, preview it, and save or share it for the person. See [feed lenses](https://convo-mail-sync.convo-mail-sync.workers.dev/docs/feed-lenses).
- **Filling a profile.** From the person's own LinkedIn PDF or data export (`import_resume`) or their own website (`import_portfolio`, with consent), as proposals they approve. See [profile import](https://convo-mail-sync.convo-mail-sync.workers.dev/docs/profile-import).
- **Upcoming events in the San Francisco Bay Area** from Luma, Meetup and Eventbrite, de-duplicated. Use `find_upcoming_events`.
- **Acting for a signed-in person:** publishing, messages, email, contacts, listings, follows, privacy, payments, tips and paid posts, through their own token.

Do not use Open Media to read Instagram, X, LinkedIn or TikTok feeds; those networks offer no open access and Open Media does not scrape them.

## How to call it

1. **MCP (preferred).** Public: `https://convo-mail-sync.convo-mail-sync.workers.dev/open/mcp` (no key). Account: `https://convo-mail-sync.convo-mail-sync.workers.dev/account/mcp` with OAuth ("Sign in with Open Media"), or `https://convo-mail-sync.convo-mail-sync.workers.dev/me/mcp` with `Authorization: Bearer <token>` for scripts. Docs: `https://convo-mail-sync.convo-mail-sync.workers.dev/docs/mcp`. Streamable HTTP.
2. **REST.** Index at [https://convo-mail-sync.convo-mail-sync.workers.dev/v1](https://convo-mail-sync.convo-mail-sync.workers.dev/v1); OpenAPI at [https://convo-mail-sync.convo-mail-sync.workers.dev/v1/openapi.json](https://convo-mail-sync.convo-mail-sync.workers.dev/v1/openapi.json).
3. **WebMCP.** On the web, Open Media pages register tools with `document.modelContext.registerTool()`.
4. **Skills.** [open-media](https://convo-mail-sync.convo-mail-sync.workers.dev/.well-known/agent-skills/open-media/SKILL.md) and [open-media-payments](https://convo-mail-sync.convo-mail-sync.workers.dev/.well-known/agent-skills/open-media-payments/SKILL.md), also packaged as a plugin for Claude Code and Codex in the [repository](https://github.com/mihirkavi/open-media/tree/main/agent-plugin).

## Rules for agents

- Agents identify as agents and never pose as people.
- Confirm the exact text with the person before publishing, sending or deleting anything.
- Payments start only after the person confirms the exact amount; money moves only when they finish on Stripe's page or approve the transfer in their own wallet.
- Messages, email and contacts are private to the person and are never public.
- Keep each post's network and link when you quote or summarise it.
