Substack Gateway OSS Documentation
Substack Gateway OSS is a stateless Python gateway for Substack. It exposes:
- A REST API at
/api/v1/* - An MCP server at
/mcp
Both interfaces share the same service layer and Substack clients, so the HTTP and MCP surfaces stay aligned.
What You Can Do
- Read public Substack profiles, posts, notes, and comments
- Access authenticated "me" endpoints with a base64-encoded credential token
- Create and delete notes through the REST API
- Use the same gateway as an MCP server for AI tools and agent workflows
- Extend the app with custom routes, MCP tools, auth providers, and lifespan hooks