# Ambush

> Ambush connects AI agents to personalized, prompt-defined news streams and delivers matching events as they happen.

Use the agent integrations guide to choose a supported package. The production MCP server uses browser OAuth; never ask a user to paste an access token or API key into a conversation. Shared Centaur deployments should use a dedicated Ambush account and secret-managed API key.

## Developer documentation

- [Agent integrations](https://app.ambush.ai/developers.md): Exact setup instructions for Codex, Grok, Eve, OpenClaw, Claude Code, skills.sh, Centaur, and generic MCP clients.
- [Human-readable developers page](https://app.ambush.ai/developers?tab=agents): Interactive installation guide and REST API reference.

## Connection

- [Production MCP server](https://api.ambush.ai/mcp): Stateless Streamable HTTP MCP endpoint with OAuth discovery.
- [Protected resource metadata](https://api.ambush.ai/.well-known/oauth-protected-resource/mcp): OAuth protected-resource discovery for the MCP endpoint.

## Open-source integrations

- [Codex plugin](https://github.com/Ambush-AI/codex-plugins): GitHub marketplace preview containing the MCP connection and stream-management skill.
- [Grok plugin](https://github.com/Ambush-AI/grok-plugins): Grok Build marketplace plugin containing the MCP connection and stream-management skill; Grok on the web can use the same server as a custom connector.
- [Vercel Eve setup](https://github.com/Ambush-AI/ambush-stream-skills#install-in-eve): Native Eve skill installation plus a user-scoped OAuth MCP connection through Vercel Connect.
- [OpenClaw plugin](https://github.com/Ambush-AI/ambush-stream-skills#install-in-openclaw): Native plugin with per-requester OAuth for interactive OpenClaw gateways.
- [Claude Code plugin](https://github.com/Ambush-AI/claude-plugins): Claude Code marketplace plugin.
- [Portable agent skill](https://github.com/Ambush-AI/ambush-stream-skills): skills.sh-compatible stream-management skill.
- [Centaur overlay](https://github.com/Ambush-AI/centaur-overlay): Pinned overlay, CLI, and skill for shared Centaur deployments.