# Surf

> Surf is a social platform that aggregates content from Mastodon, Bluesky, and RSS into unified feeds. The Surf API provides programmatic access to feeds, posts, search, AI-powered features, content processing, audio, and more.

## API

- [Developer Portal](https://surf.social/devportal/v1/getting-started): Getting started guide, authentication, rate limits, and SDK installation
- [API Reference](https://surf.social/devportal/v1/api-docs): Complete OpenAPI documentation for all 128 REST endpoints
- [MCP Integration Guide](https://surf.social/devportal/v1/mcp-guide): 44 MCP tools for AI agents -- search, summarize, create, post, and podcast intelligence
- [Feed Themes](https://surf.social/devportal/v1/feed-themes): Visual theming for custom feeds with semantic color tokens
- [Tutorials](https://surf.social/devportal/v1/tutorials): Step-by-step guides including AI agent development
- [Error Catalog](https://surf.social/devportal/v1/errors): All error codes and resolution steps
- [Changelog](https://surf.social/devportal/v1/changelog): API updates and new features

## MCP

- [MCP Server](https://mcp.surf.social/mcp): Streamable HTTP MCP server with 44 tools for AI agents
- [OAuth Discovery](https://mcp.surf.social/.well-known/oauth-authorization-server): OAuth 2.0 with PKCE for authenticated MCP operations

## SDKs

- [Python SDK](https://github.com/Flipboard/surf-sdks/tree/main/python): Sync + async client, SurfAgent wrapper, typed models
- [TypeScript SDK](https://github.com/Flipboard/surf-sdks/tree/main/typescript): Full TypeScript types, SurfAgent wrapper
- [Go SDK](https://github.com/Flipboard/surf-sdks/tree/main/go): Idiomatic Go client
- [Java SDK](https://github.com/Flipboard/surf-sdks/tree/main/java): Java 17+ with Jackson records

## Capabilities

- Search feeds, posts, and accounts across Mastodon, Bluesky, and RSS
- AI-powered feed summaries, natural language Q&A, and feed building
- Create and manage custom feeds with operators (topics, hashtags, accounts, RSS)
- Visual feed theming with semantic color tokens (Material Design 3 style)
- Post to Mastodon and Bluesky, favourite posts, set feed themes
- Content extraction, URL resolution, image analysis, text-to-speech
- Podcast intelligence: semantic search over transcribed episodes, entity mentions with timestamps, guest search, sponsor/ad intelligence, show notes and chapters
- Podcast listening tools: clips, catch-up summaries, skip-to-topic navigation, ad/intro skip points, fact-checks, transcript translations
- OAuth 2.0 with PKCE for user-delegated access
- Rate-limited API with Free, Basic, Pro, and Enterprise tiers