Base URL

https://slashfeed.app/api/v1

Request

curl https://slashfeed.app/api/v1/me \
-H "Authorization: Bearer sk_live_xxx"

Response

{
  "id": "019e02ab-...",
  "email": "[email protected]",
  "confirmed": true,
  "created_at": "2025-01-01T00:00:00Z"
}

Authenticated request

curl https://slashfeed.app/api/v1/me \
-H "Authorization: Bearer sk_live_Rn8KdPwXmZq5"

401 — invalid token

{
  "error": "unauthorized",
  "message": "Invalid or missing API token"
}

Response headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987

429 — limit exceeded

{
  "error": "too_many_requests",
  "message": "Rate limit exceeded",
  "retry_after": 3600
}

Error object

{
  "error": "not_found",
  "message": "Resource not found"
}

422 — validation error

{
  "error": "unprocessable_entity",
  "message": "Validation failed",
  "errors": {
    "name": ["can't be blank"],
    "url":  ["must be a valid HTTP or HTTPS URL"]
  }
}

Feed object

{
  "id": "019e02ab-...",
  "feed_id": "019e01ff-...",
  "url": "https://example.com/feed.xml",
  "title": "Example Blog",
  "custom_title": null,
  "category_id": "019e03aa-...",
  "unread_count": 12,
  "last_fetched_at": "2025-01-15T08:30:00Z",
  "fetch_error": null
}

Entry object

{
  "id": "019e05cc-...",
  "feed_id": "019e01ff-...",
  "title": "Hello, Elixir 2.0",
  "url": "https://example.com/posts/hello",
  "author": "Jane Doe",
  "published_at": "2025-01-14T18:00:00Z",
  "read": false,
  "starred": false,
  "saved_for_later": false
}

Category object

{
  "id": "019e03aa-...",
  "name": "Tech News",
  "color": "#6366f1",
  "position": 0
}

Tag object

{
  "id": "019e07bb-...",
  "name": "must-read",
  "color": "#10b981"
}

X-Auth-Token header

curl https://yourserver.com/v1/me \
-H "X-Auth-Token: sk_live_xxx"

HTTP Basic Auth (alternative)

# Any username, token as password
curl https://yourserver.com/v1/feeds \
-u "user:sk_live_xxx"

User object (Miniflux format)

{
  "id": 1234567,
  "username": "[email protected]",
  "is_admin": false,
  "language": "en_US",
  "timezone": "UTC",
  "theme": "light",
  "entry_sorting_direction": "desc"
}

Fever request

curl -X POST "https://yourserver.com/fever?feeds" \
-d "api_key=5f4dcc3b5aa765d61d8327deb882cf99"

Successful response

{
  "api_version": 3,
  "auth": 1,
  "last_refreshed_on_time": "1736928000",
  "feeds": [
    {
      "id": 12345678,
      "title": "Example Blog",
      "url": "https://example.com/feed.xml",
      "is_spark": 0
    }
  ]
}

Example tool call

POST /api/mcp
Authorization: Bearer <token>
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_my_feeds",
    "arguments": {}
  }
}

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[019e…] Hacker News [Tech]\n  url: https://news.ycombinator.com/rss | last_fetched: 2026-05-21T08:00:00Z\n\n[019f…] The Register\n  url: https://www.theregister.com/headlines.atom | last_fetched: 2026-05-21T07:45:00Z"
      }
    ]
  }
}

Register a client (run once)

mix boring_rss.oauth.create_client \
  --name "Claude Desktop" \
  --redirect-uri "http://localhost:8888/callback" \
  --grants "authorization_code,refresh_token" \
  --scopes "feeds:read,entries:read,entries:write,categories:read,stats:read" \
  --pkce \
  --access-ttl 3600 \
  --refresh-ttl 2592000

# → client_id: 019f1a2b-...  (no secret — PKCE public client)

PKCE authorization flow

# 1. Generate PKCE pair (your MCP client does this automatically)
code_verifier  = random 32-byte hex string
code_challenge = BASE64URL(SHA-256(code_verifier))

# 2. Open in browser
GET /oauth/authorize
  ?client_id=019f1a2b-...
  &redirect_uri=http://localhost:8888/callback
  &response_type=code
  &scope=feeds:read+entries:read+stats:read
  &code_challenge=<challenge>
  &code_challenge_method=S256

# 3. User logs in → redirected to callback with ?code=…

# 4. Exchange code for tokens
POST /oauth/token
  grant_type=authorization_code
  &code=<code>
  &code_verifier=<verifier>
  &client_id=019f1a2b-...

# → {"access_token": "…", "expires_in": 3600, "refresh_token": "…"}

Refresh an expired token

POST /oauth/token
  grant_type=refresh_token
  &refresh_token=<refresh_token>
  &client_id=019f1a2b-...

Generate & use

# In Settings → MCP Access Token, click "Generate Token"
# Copy the 64-character token shown once:
# a3f9e2b1c4d5...  (64 hex chars)

# Use it as a Bearer token in any HTTP client:
curl -N https://slashfeed.app/api/mcp \
  -H "Authorization: Bearer a3f9e2b1c4d5..."

Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "slashfeed": {
      "type": "http",
      "url": "https://slashfeed.app/api/mcp",
      "oauth": {
        "client_id": "019f1a2b-...",
        "authorization_url": "https://slashfeed.app/oauth/authorize",
        "token_url": "https://slashfeed.app/oauth/token",
        "scope": "feeds:read entries:read entries:write categories:read stats:read"
      }
    }
  }
}

Cursor

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "slashfeed": {
      "type": "http",
      "url": "https://slashfeed.app/api/mcp",
      "oauth": {
        "client_id": "019f1a2b-...",
        "authorization_url": "https://slashfeed.app/oauth/authorize",
        "token_url": "https://slashfeed.app/oauth/token",
        "scope": "feeds:read entries:read entries:write categories:read stats:read"
      }
    }
  }
}

Zed

// ~/.config/zed/settings.json  (inside "assistant" key)
{
  "assistant": {
    "version": "2",
    "mcp_servers": {
      "slashfeed": {
        "type": "http",
        "url": "https://slashfeed.app/api/mcp",
        "oauth": {
          "client_id": "019f1a2b-...",
          "discovery_url": "https://slashfeed.app/.well-known/openid-configuration",
          "scope": "feeds:read entries:read entries:write categories:read stats:read"
        }
      }
    }
  }
}

Personal token (any client)

// Any client — paste your personal token directly:
{
  "mcpServers": {
    "slashfeed": {
      "type": "http",
      "url": "https://slashfeed.app/api/mcp",
      "headers": {
        "Authorization": "Bearer a3f9e2b1c4d5..."
      }
    }
  }
}

Insomnia — environment variables

{
  "base_url": "https://yourserver.com",
  "api_token": "sk_live_your_token_here"
}

[
  { "key": "base_url",   "value": "https://yourserver.com",   "secret": false },
  { "key": "api_token",  "value": "sk_live_your_token_here",  "secret": true  }
]