FeedNest README | AllMCPs

FeedNest MCP Server

Your sources. Not the whole web. Ask your AI about your feeds - it already knows.

ChatGPT searches the internet. Perplexity crawls billions of pages. When you ask about your industry, your interests, your world - they give you everything except what matters.

FeedNest is different. Your AI works exclusively with the sources you choose: the blogs you trust, the publications you follow, the experts you believe in. No algorithmic noise. No black-box results. Intelligence grounded in your world.

This MCP server gives any AI assistant - ChatGPT, Codex, Claude, Gemini, Grok, Cursor, Windsurf, Cline, Le Chat, and more - direct access to your feeds, articles, highlights, notes, and tags through natural language.

What Your AI Can Do

Just ask. Your AI handles the rest.

Morning briefings - Wake up to a summary of everything that happened overnight across your feeds
Compare coverage - See how different sources report the same story, side by side
Spot trends early - Your AI detects emerging patterns before they hit mainstream
Deep-dive any topic - Get a comprehensive synthesis from every source you follow
Track developing stories - Follow a narrative as it evolves across all your feeds
Instant search - Find any article across all your sources in seconds
Highlights and notes - Save what matters and annotate with your own thoughts

Quick Start

Prerequisites

A FeedNest account. Apps that connect with OAuth (ChatGPT, Claude) work on every plan: on Free they can read your feeds and articles, up to 20 requests an hour; Plus and Pro also let them save, tag, highlight, take notes and mark articles as read.
For clients set up with an API key: a key from Settings → Developer API, which needs a Pro subscription

ChatGPT

Option A: Web UI (OAuth - recommended)

Go to Settings → Apps & Connectors → Advanced and enable Developer Mode
Go to Settings → Apps → Create. Name it FeedNest and set the URL to https://mcp.feednest.com
ChatGPT will redirect you to FeedNest - log in and authorize

No API key needed. ChatGPT handles the OAuth flow automatically.

Option B: Responses API

Include FeedNest as an MCP tool in your API request:

config.json

{
  "type": "mcp",
  "server_url": "https://mcp.feednest.com",
  "server_label": "feednest",
  "authorization": "fn_live_YOUR_API_KEY"
}

Codex

Option A: Plugin (recommended)

The plugin bundles skills, MCP config, and brand assets in one install. It is not in the Codex plugin directory yet, so install it from this repository: see Local Installation in the Codex plugin README.

Option B: MCP in config.toml

Add to ~/.codex/config.toml:

toml

[mcp_servers.feednest]
url = "https://mcp.feednest.com"
bearer_token_env_var = "FEEDNEST_API_KEY"

server.ts

export FEEDNEST_API_KEY="fn_live_YOUR_API_KEY"

Or via CLI:

bash

codex mcp add feednest --transport http https://mcp.feednest.com

Claude

Connectors directory (OAuth - recommended)

FeedNest is listed in Claude's connectors directory.

Open claude.ai/directory/feednest, or search for FeedNest in Customize → Connectors
Click Connect to Claude, log in to FeedNest, and authorize

No API key needed, and the connector follows your Claude account to Claude Desktop and the mobile apps.

To add it by URL instead, add a custom connector in Customize → Connectors with the URL https://mcp.feednest.com and leave OAuth Client ID and Secret empty.

Claude Code

Terminal

claude mcp add --transport http feednest https://mcp.feednest.com \
  --header "Authorization: Bearer fn_live_YOUR_API_KEY"

Add -s user for global access across all projects.

Claude Desktop config file (requires bridge)

The directory connector above already works in Claude Desktop. To configure FeedNest in claude_desktop_config.json instead, which only runs stdio servers, use the mcp-remote bridge:

config.json

{
  "mcpServers": {
    "feednest": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.feednest.com",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

Config path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows), or ~/.config/Claude/claude_desktop_config.json (Linux).

Cursor

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global):

config.json

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

Tip: Cursor supports env var interpolation: "Bearer ${env:FEEDNEST_API_KEY}". Do not add a "type" field - Cursor auto-detects from the "url" key.

Le Chat (Mistral)

Available on all plans, including the free tier.

Go to Sidebar → Intelligence → Connectors
Click + Add Connector → Custom MCP Connector
Set Name to FeedNest, Server URL to https://mcp.feednest.com
Set Auth type to API Token Authentication, Authorization to Bearer fn_live_YOUR_API_KEY

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

config.json

{
  "mcpServers": {
    "feednest": {
      "serverUrl": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

Important: Windsurf uses "serverUrl" (not "url"). Using the wrong key causes a silent failure.

Cline

In VS Code, open Cline extension settings → MCP Servers configuration (JSON):

config.json

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

Critical: The "type": "streamableHttp" field is mandatory for Cline. Without it, custom headers may fail silently and authentication won't work.

Gemini CLI

Add to ~/.gemini/settings.json:

config.json

{
  "mcpServers": {
    "feednest": {
      "httpUrl": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

Note: Gemini CLI uses "httpUrl" (not "url"). The "url" field is reserved for SSE transport. CLI only - gemini.google.com does not support external MCP servers.

Grok (xAI)

Available through the xAI API/SDK only, not from the grok.com chat UI.

Terminal

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-3",
    "tools": [{
      "type": "mcp",
      "server_url": "https://mcp.feednest.com",
      "server_label": "feednest",
      "authorization": "Bearer fn_live_YOUR_API_KEY"
    }],
    "input": "What are my unread articles?"
  }'

Any other MCP client

Any client supporting Streamable HTTP can connect using:

URL: https://mcp.feednest.com
Header: Authorization: Bearer fn_live_YOUR_API_KEY

For stdio-only clients, use the mcp-remote bridge:

config.json

{
  "mcpServers": {
    "feednest": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.feednest.com",
        "--header", "Authorization:Bearer fn_live_YOUR_API_KEY"
      ]
    }
  }
}

Tools (25)

Articles

Tool	Description	Key Parameters
`get_articles`	List articles with title, source, date, and summary preview. Views: newsfeed, by-feed, by-folder, by-tag, tagged, highlighted, noted.	`view`*, `feed_id`, `folder_id`, `tag_id`, `limit`, `query`, `sort`, `unread_only`, `date_from`, `date_to`, `count_only`
`get_article`	Get full article content including highlights, notes, and reading time.	`article_id`*
`extract_article`	Fetch full content from the original URL when RSS truncated it.	`article_id`*

Read Status

Tool	Description	Key Parameters
`mark_as_read`	Mark an article as read.	`article_id`*
`mark_as_unread`	Mark an article as unread.	`article_id`*
`mark_all_as_read`	Mark all articles as read, optionally filtered by feed or folder.	`feed_id`, `folder_id`

Saving

Tool	Description	Key Parameters
`save_article`	Save an article for later reading.	`article_id`*
`unsave_article`	Remove an article from saved items.	`article_id`*
`save_url`	Save an external URL for later reading.	`url`*
`get_saved`	List saved articles with search, date filtering, and sorting.	`limit`, `query`, `sort`, `date_from`, `date_to`

Feeds & Structure

Tool	Description	Key Parameters
`get_feeds`	List subscribed feeds with unread counts. Search by name.	`folder_id`, `query`, `limit`
`get_folders`	List all feed folders with feed counts.	-
`get_tags`	List all tags with article counts.	-

Tagging

Tool	Description	Key Parameters
`create_tag`	Create a new tag for categorizing articles.	`name`*, `color`
`delete_tag`	Delete a tag by ID.	`tag_id`*
`tag_article`	Add or remove a tag on an article.	`article_id`, `tag_id`, `action`* (`add`/`remove`)

Highlights

Tool	Description	Key Parameters
`get_highlights`	Get all text highlights from an article.	`article_id`*
`add_highlight`	Highlight a text passage. The text must exist exactly in the article.	`article_id`, `text`, `color`
`remove_highlight`	Remove a highlight from an article.	`article_id`, `highlight_id`

Notes

Tool	Description	Key Parameters
`get_notes`	Get the note on an article.	`article_id`*
`add_note`	Add or update a note on an article.	`article_id`, `content`
`delete_note`	Delete a note from an article.	`article_id`*

History

Tool	Description	Key Parameters
`get_recently_read`	Get recently opened articles. Supports search and date filtering.	`limit`, `since`, `date_to`, `query`, `sort`

Output Feeds

Tool	Description	Key Parameters
`get_output_feeds`	List public RSS output feeds created by the user.	-

AI

text_to_speech is not exposed by the hosted MCP server: it generates audio with an AI model, which the Claude connectors directory does not allow. Reading articles aloud stays available in the FeedNest app and through the OpenClaw plugin.

Stats

Tool	Description	Key Parameters
`get_stats`	Reading streak, articles read today, reading time, total feeds, unread count, saved count.	-

* = required parameter

Example Conversation

Code

You: "What's happening in AI today?"

ChatGPT: "Based on your tech feeds, here are today's 3 biggest stories:

1. OpenAI announced GPT-5, covered first in your Hacker News feed
2. EU AI Act enforcement begins, mentioned across 4 of your sources
3. Google published new Gemini research, from your AI folder

Want me to summarize any of them?"

More things you can ask

"Give me a morning briefing from my feeds"
"Compare how Bloomberg and Reuters covered this story"
"What did I read yesterday?"
"Save this article and highlight the key findings"
"Tag all AI-related articles with 'Machine Learning'"
"How's my reading streak going?"

Authentication

API Key (personal use)

Generate a key from Settings → Developer API in the FeedNest dashboard. Keys start with fn_live_ followed by 32 hex characters.

Code

Authorization: Bearer fn_live_abc123...

OAuth 2.1 (third-party apps)

The server supports full OAuth 2.1 with PKCE. Discovery endpoint:

Code

https://mcp.feednest.com/.well-known/oauth-protected-resource

ChatGPT and Claude.ai handle OAuth automatically - no API key needed for those.

Plans

Apps that connect with OAuth work on every FeedNest plan. API keys need Pro.

	Free	Plus	Pro
Read feeds, folders, articles, saved articles, tags, reading history and output feeds	Yes	Yes	Yes
An article's highlights	Yes	Yes	Yes
Notes, the `highlighted` and `noted` views, reading statistics	No	Yes	Yes
Changes: mark as read, save, tag, highlight, take notes, load an article's full text	No	Yes	Yes
Date filters (`date_from`, `date_to`, `since`)	No	No	Yes
Requests an hour	20 tool calls	1,000	1,000
API keys	No	No	Yes

A connected app picks up a plan change at its next token refresh, within an hour, or right away when you reconnect FeedNest.

Scopes

Scope	Access
`read`	All read-only tools (get_articles, get_feeds, get_stats, etc.)
`write`	All mutation tools (mark_as_read, save_article, add_highlight, etc.)
`ai`	No MCP tool at the moment (see AI above)

You Stay in Control

You choose what's visible - Pick exactly which feeds, folders, and actions your AI can access
Encrypted and verified - Every request is secured so no one else can reach your data
Built-in usage limits - 1,000 requests an hour (20 tool calls on Free), so your account stays protected
Revoke access instantly - One click from your dashboard

Troubleshooting

Issue	Solution
"Bearer token required"	Check that the `Authorization` header is set correctly
"Invalid API key format"	Key must start with `fn_live_` followed by 32 hex characters
"Invalid or revoked API key"	Regenerate from Settings → Developer API
"API access requires a Pro subscription"	API keys need Pro. Upgrade at feednest.com, or connect with OAuth, which works on every plan
"...included in FeedNest Plus and Pro"	The account is on the Free plan, where apps can read feeds, articles, saved articles, tags and highlights but not change anything. After upgrading, reconnect FeedNest so the app gets the new plan. See Plans
"Filtering by date is included in FeedNest Pro"	Date filters need Pro. Without them, articles still come newest first
"...includes 20 requests an hour from AI assistants"	The Free plan's hourly allowance is used up. Try again after the wait the message gives
"Rate limit reached"	Wait a few minutes and retry
"Insufficient scope"	Your API key doesn't have the required scope
Tools not appearing	Restart your AI client after changing MCP configuration

Packages

This repository is a monorepo containing the client libraries and plugins for the FeedNest MCP server.

Package	npm	Description
`@feednest/sdk`		TypeScript SDK — typed HTTP client for the FeedNest API v1
`@feednest/openclaw`		OpenClaw plugin — 26 agent tools for AI assistants
Codex plugin	—	OpenAI Codex plugin — skills + MCP config for Codex agents
`@feednest/shared-tool-defs`	private	Shared Zod schemas and text formatters (bundled into the plugin)

Development

Terminal

npm install
npm run build    # Build all packages (sdk → shared-tool-defs → openclaw-plugin)
npm test         # Run all tests
npm run type-check

License

MIT

FeedNest MCP Server

What Your AI Can Do

Quick Start

Prerequisites

ChatGPT

Option A: Web UI (OAuth - recommended)

Option B: Responses API

Codex

Option A: Plugin (recommended)

Option B: MCP in config.toml

Claude

Connectors directory (OAuth - recommended)

Claude Code

Claude Desktop config file (requires bridge)

Cursor

Le Chat (Mistral)

Windsurf

Cline

Gemini CLI

Grok (xAI)

Any other MCP client

Tools (25)

Articles

Read Status

Saving

Feeds & Structure

Tagging

Highlights

Notes

History

Output Feeds

AI

Stats

Example Conversation

More things you can ask

Authentication

API Key (personal use)

OAuth 2.1 (third-party apps)

Plans

Scopes

You Stay in Control

Troubleshooting

Packages

Development

Links

License