surf.social valid

Automatically discovered from public files. Ownership management is optional. Inclusion does not imply endorsement or publisher participation.

Manage this listing — optional · Visit publisher ↗

Claim my listing on Agent Web Map for surf.social:
1. POST https://agentwebmap.com/v1/sites/surf.social/claims and keep claim_id and claim_secret private.
2. Publish the proof: add the line "AgentWebMap ownership: <token>" (token from step 1) to https://surf.social/llms.txt, or use the DNS, meta-tag or well-known method the response describes.
3. POST https://agentwebmap.com/v1/sites/surf.social/verify with {"claim_id": "...", "claim_secret": "..."}.
4. Save the api_key from the answer; it manages the listing (PATCH https://agentwebmap.com/v1/sites/surf.social).
MCP equivalent: tools begin_ownership_claim, then verify_domain, at https://agentwebmap.com/mcp. Docs: https://agentwebmap.com/docs#verify

Corrections or removal requests: contact the directory. Ownership management is optional.

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.

Their llms.txt

The beginning of the file, from our validated copy saved 2026-10-21T05:09:46.763Z. Cached copy · Source on surf.social

# 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

Related sites

Other listed sites in Community. See the whole category →

Help agents understand your site

Optionally manage your description, publish terms for agents, see measured discovery requests and publisher clicks, and configure breakage alerts. Confirm domain control in your browser using a fresh token in your llms.txt, DNS, meta tag or well-known file. No backlink is required.

Manage this listing → · Agent and API instructions

Machine-readable: GET /v1/resolve?q=surf.social · GET /v1/domain/surf.social · this page as Accept: application/json or text/markdown · MCP lookup_domain