Stream MCP Server

What is Stream?

The Stream MCP Server is a Model Context Protocol server for the Stream (streampay.sa) payment platform. It exposes 27 tools across six resource domains — payment links, customers, products, coupons, invoices, and payments — plus a read-only OpenAPI documentation resource. The server is built with FastMCP and targets developers building AI assistants that interact with Stream’s payment infrastructure.

How to use Stream?

Install the server via pip install -e ".[dev]", set the STREAM_API_KEY environment variable, and run stream-mcp for stdio mode or stream-mcp-remote for remote HTTP mode. Configure your MCP client (Claude Desktop, Cursor, VS Code) with either a stdio command or a remote URL that passes the API key as a Bearer token. The server can also be deployed with Docker for hosted access.

Key features of Stream

• 27 tools covering payment links, customers, products, coupons, invoices, and payments
• Read-only OpenAPI spec resource available at stream://docs/openapi
• Supports both local stdio and remote HTTP (URL) modes
• Per-user authentication via Bearer token in remote mode
• Structured error handling with StreamAPIError returning {error, code, message}
• Configurable timeout, retries, and base URL via environment variables

Use cases of Stream

• Create and manage payment links for one-time checkouts
• Manage customer records with create, read, update, and soft-delete operations
• Create and update products (one-time or recurring) and archive them
• Generate and handle fixed or percentage discount coupons
• Create ZATCA-compliant invoices, send them, and void unpaid ones
• List, retrieve, and refund payments with full or partial refunds