Docs
Sign In

General Guide

Available

Connect any MCP-compatible AI client to FeedNest using Streamable HTTP.

Prerequisites

Connection details

Server URLhttps://mcp.feednest.com
TransportStreamable HTTP (MCP 2025+ standard)
AuthenticationBearer token in Authorization header
CompatibilityAny client supporting Streamable HTTP or SSE

Generic MCP configuration

Replace fn_live_... with your actual API key

{
  "mcpServers": {
    "feednest": {
      "url": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_..."
      }
    }
  }
}

Environment variables

Most MCP clients support environment variable interpolation. Store your key as FEEDNEST_API_KEY and reference it with your client's syntax (e.g., ${FEEDNEST_API_KEY}, ${env:FEEDNEST_API_KEY}).

Verify your connection

After setup, try one of these prompts to confirm everything is working:

  • →“What are my unread articles?”
  • →“Summarize my latest saved articles”
  • →“How many feeds am I subscribed to?”

Available tools (25)

FeedNest's MCP server exposes 25 tools covering feeds, articles, highlights, notes, tags, and AI features:

get_articlesList articles from different views: newsfeed, by feed, by folder, by tag, tagged, highlighted, or noted. Supports pagination, search, and date filtering.
get_articleGet full details of a specific article including content, highlights, notes, and reading time.
extract_articleLoad full article content from the original URL. Use when the article content is truncated or missing.
mark_as_readMark an article as read.
mark_as_unreadMark an article as unread.
mark_all_as_readMark all articles as read. Optionally filter by a specific feed or folder.
save_articleSave an article for later reading.
unsave_articleRemove an article from saved items.
save_urlSave an external URL for later reading.
get_savedList saved articles. Supports pagination, search, date filtering, and sorting.
get_feedsList subscribed feeds with unread counts. Supports websites, podcasts, YouTube, and Google News. Optionally filter by folder.
get_foldersList all feed folders with the number of feeds in each.
get_tagsList all user-defined tags with article counts.
create_tagCreate a new tag for categorizing articles.
tag_articleAdd or remove a tag on an article.
get_highlightsGet all text highlights from an article.
add_highlightHighlight a text passage in an article.
remove_highlightRemove a highlight from an article.
get_notesGet the note on an article.
add_noteAdd or update a note on an article.
delete_noteDelete a note from an article.
get_recently_readGet recently read articles ordered by when they were opened. Supports pagination and date range filtering.
get_output_feedsList public RSS output feeds created by the user.
text_to_speechGenerate audio from an article using text-to-speech. Returns the audio URL and duration.
get_statsGet reading statistics including streak, articles read today, reading time, and unread count.

Troubleshooting

401 Unauthorized

Check that your API key is valid and hasn't been revoked. Ensure the Authorization header is formatted as 'Bearer fn_live_...' (with a space after Bearer).

403 Forbidden

Your API key may not have the required scope for the tool you're calling. Check your key's permissions in Settings → Developer API.

Connection refused or timeout

Verify the server URL is https://mcp.feednest.com (not http). Check your network connection and firewall settings.

Tools not appearing

Restart your AI client after changing the MCP configuration. Some clients require a full restart to detect new servers.