Docs
Sign In

General Guide

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

Prerequisites

  • A FeedNest account

    Apps that connect with OAuth, like ChatGPT and Claude, work on every plan: read-only on Free, full access on Plus and Pro. API keys need Pro. View pricing

  • API key, for apps set up with a key

    Create one in Settings → Developer API or follow the API keys guide

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 with title, source, date, and summary preview. Views: newsfeed, by-feed, by-folder, by-tag, tagged, highlighted, noted. count_only returns only the number of matching articles.
get_articleGet an article's content from its RSS feed, with its highlights, notes, and estimated reading time. Some feeds publish only an excerpt.
extract_articleFetch the full text of an article from the publisher's original page, for feeds that publish only an excerpt.
mark_as_readMark an article as read.
mark_as_unreadMark an article as unread.
mark_all_as_readMark all articles as read, optionally limited to one 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, optionally filtered by name or 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.
delete_tagDelete a user-created tag by ID.
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. The text must exist exactly in the article content.
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 filtering.
get_output_feedsList public RSS output feeds created by the user.
get_statsGet reading statistics: streak, articles read today, reading time, total feeds, unread count, and saved 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.