# Agent Media Toolkit

**15 media & data tools your AI agent can hire per call.** One hosted endpoint — web
search, news, web-page extraction, summarizing, translation, moderation, script writing,
text-to-voiceover, transcription, subtitles, viral-clip discovery, and short-form video
editing. No API key, no signup. **Free over MCP** for the lighter tools; premium media
tools are **pay-per-call in USDC on Base via [x402](https://x402.org)**.

- 🌐 **Homepage / live demo:** https://podcast-shorts-a2a-production.up.railway.app/
- 🔌 **MCP endpoint (remote, streamable HTTP):** `https://podcast-shorts-a2a-production.up.railway.app/mcp/`
- 🧾 **Agent card:** https://podcast-shorts-a2a-production.up.railway.app/.well-known/agent.json
- 💵 **Pricing:** https://podcast-shorts-a2a-production.up.railway.app/pricing

This is a **hosted** MCP server — there is nothing to install or run. Point your MCP
client at the endpoint above and the tools appear.

## Add it to your MCP client

```json
{
  "mcpServers": {
    "agent-media-toolkit": {
      "url": "https://podcast-shorts-a2a-production.up.railway.app/mcp/"
    }
  }
}
```

Works with any MCP client that supports remote **streamable HTTP** servers (Claude,
Cursor, and MCP-compatible agent frameworks).

## The tools

| Tool | Tier | What it does |
|------|------|--------------|
| `search` | free | Live web search → title/url/snippet |
| `news` | free | Recent news for a query, with dates + sources |
| `extract` | free | Web page → clean main-content text |
| `summarize` | free | TL;DR any text or a URL (paragraph or bullets) |
| `repurpose` | free | Text → thread, summary, titles, hashtags |
| `translate` | free | Translate text into any language |
| `script` | free | Topic → short-form video script (hook/beats/CTA) |
| `moderate` | free | Content-safety classification |
| `media_info` | free | Media URL → metadata, no download |
| `voiceover` | free | Text → natural MP3 narration |
| `package_post` | free | Clip → platform titles/description/hashtags |
| `transcribe` | $0.25 | Audio/video → timestamped transcript |
| `subtitles` | $0.05 | Audio/video → `.srt` / `.vtt` caption file |
| `find_clips` | $1.50 | Long video → scored viral clip candidates |
| `edit_clip` | $3.00 | Time range → finished 9:16 captioned short |

Premium tools return a pointer to their paid [x402](https://x402.org) endpoint; an unpaid
HTTP request answers `402 Payment Required` with a USDC-on-Base price quote, the agent
pays, and the result is returned.

## Also available over plain HTTP (x402)

Every tool is also a pay-per-call HTTP endpoint. Example:

```
POST https://podcast-shorts-a2a-production.up.railway.app/search
{ "query": "agent commerce protocol", "max_results": 5 }
→ 402 Payment Required  ($0.02, USDC on Base)
→ pay + retry → JSON results
```

## Example: connect from Python

See [`examples/client.py`](examples/client.py).

## License

MIT — see [LICENSE](LICENSE). The hosted service is operated by The Solo Stack; this repo
documents how to use it.