Skip to content

freshrss-agent

FreshRSS API + MCP Server + A2A Agent for the agent-utilities ecosystem — a typed, action-routed connector.

Official documentation

This site is the canonical reference for freshrss-agent, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

freshrss-agent wraps the target service with typed, deterministic MCP tools and an optional Pydantic-AI agent server.

The connector remains inactive when credentials are absent: configure FRESHRSS_URL and FRESHRSS_API_PASSWORD to connect it to an instance.

Explore the documentation

  • Installation — pip, source, extras, and the prebuilt Docker image.
  • Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
  • Usage — the MCP tools, the Python client, and the CLI.
  • Backing Platform — deploy the target service with Docker.
  • Overview — the action-routed tool surface and architecture.
  • Concepts — the CONCEPT ID registry.