altsfor

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:

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

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.

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.

Canonical documentation URL: https://altsfor.com/docs