altsfor API & MCP Server Documentation
Search software alternatives, browse weekly product launches, and submit products programmatically over our Model Context Protocol (MCP) server or public REST API.
Quick links & specifications
Authentication
Read operations (searching apps, listing launches, reading product alternatives, and fetching the taxonomy) are open and require no authentication.
Write operations (submit_app over MCP or POST /api/apps over REST) require a Bearer token tied to an altsfor account:
- MCP token: Sign in at https://altsfor.com/submit#mcp to create a long-lived token and pass it as
Authorization: Bearer <token>. - OAuth 2.1 (PKCE + Dynamic Client Registration): Agents can register dynamically at
https://altsfor.com/oauth/registerand authenticate users withS256PKCE. See https://altsfor.com/auth.md and /.well-known/oauth-authorization-server.
altsfor MCP Server
The altsfor MCP server uses Stateless Streamable HTTP (JSON-RPC 2.0) at POST https://altsfor.com/mcp. Add it to Claude Code, Cursor, or any MCP client:
claude mcp add --transport http altsfor https://altsfor.com/mcp --header "Authorization: Bearer <token>"Tools
search_apps(open, read-only): Search software products by name, tagline, or category before submitting.submit_app(Bearer token required): List a new software product or update one of your own listings. Accepts taxonomy enum IDs fromtools/list.
Example MCP request: search_apps
curl -sS -X POST https://altsfor.com/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_apps",
"arguments": { "query": "notion" }
}
}'REST API Endpoints
All REST endpoints return application/json. The full machine-readable specification is published at https://altsfor.com/openapi.json.
GET /api/apps?q=&category=&sort=&after=— List or search software products (60 per page, keyset pagination vianext).GET /api/apps/{slug}?filter=— Get a product, its ranked alternatives, available facet filters, and comments.POST /api/apps— Submit a new software product (Bearer token required).GET /api/launches?after=— List weekly product launches ordered by week and upvotes.GET /api/search?q=— Typeahead search returning matching apps and categories.GET /api/taxonomy— List all valid pricing, license, platform, category, and feature IDs.
Example REST request: list apps
curl -sS "https://altsfor.com/api/apps?q=notion"JSON Error Responses
Every API and MCP error returns structured JSON with a machine-readable code, human-readable message, and resolution hint:
{
"error": "not_found",
"code": "not_found",
"message": "not found",
"hint": "Search apps first via GET /api/apps?q=<query> or MCP search_apps.",
"docs_url": "https://altsfor.com/docs"
}MCP protocol and tool errors at POST /mcp return JSON-RPC 2.0 error objects with numeric error.code, error.message, and structured error.data.code and error.data.hint.
Markdown for Agents
Send Accept: text/markdown on any GET page request (including 404 responses) to receive clean Markdown with Content-Type: text/markdown; charset=utf-8 and an x-markdown-tokens estimate header.