medium-mcp
Provides tools for retrieving user info, articles, publications, tags, and search results from Medium content.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
medium-mcp
MCP server for Medium content via the unofficial medium2 RapidAPI.
Capabilities
13 tools + the free budget readout:
user_info(one-ofuser_id/username)user_articlesarticle_metadataarticle_content(full text opt-in, see Content policy below)article_responsespublication_info(one-ofpublication_id/slug)publication_articlestag_infotag_latestsearch_articlessearch_userssearch_publicationsbudget_remaining— local read, never hits RapidAPI
Related MCP server: MCP Medium Server
Source
Data comes from the unofficial medium2 API on RapidAPI. The official Medium API was archived March 2023 and does not accept new integrations; medium-mcp is the project that documents what shape the unofficial API returns and how the budget guard turns it into a metered-but-capped service.
Setup
Sign up at https://rapidapi.com and subscribe to medium2 (free tier: 150 calls / month).
Export the key:
export MEDIUM_MCP_RAPIDAPI_KEY=<your-key>Install + run:
uv pip install -e ".[dev]" medium-mcp
Health
Two routes, answering different questions:
/health— always HTTP 200. Reports per-feed detail incomponents. For orchestrators andcurlsmoke probes./readyz— HTTP 503 when a required feed has not yet returned data, 200 otherwise. For readiness probes.
The budget counter requires an initial tool call to initialize, so a freshly
started server returns 503 on /readyz until a tool call succeeds. That is
intentional: a server whose counter has never been touched cannot guarantee
its budget, and lies would defeat the only guard we have.
Budget
The server enforces a strict monthly budget (medium_mcp.budget.monthly_budget,
default 150 metered calls / period) under a backend advisory lock.
Once exhausted, metered calls are refused with this payload:
{
"error": "budget_exhausted",
"remaining_calls": 0,
"requested_calls": 1,
"period": "2026-09",
"resets_at": "2026-10-01T00:00:00Z",
"retryable": false,
"cached_alternatives": ["user_info", "article_metadata", "tag_info"]
}budget_remaining is always free; it reads the counter locally and reports
calls_used, remaining_calls, monthly_budget, period, resets_at so
the caller can decide whether to make the call themselves.
Content policy
article_content returns the full body only when the caller passes
include_full_text=True. Five rules govern what the tool does and does not
return, in order:
Default-deny.
article_contentreturnsexcerptonly wheninclude_full_text=False, regardless of cache state. The cache may holdfull_textunder thecontent_keyprefix; the gate is at the return point, not the cache key.Opt-in body. Set
include_full_text=Trueto receivefull_textalongside the excerpt. The cache hit path also honors the flag — a cached body is only returned when the flag was set.Truncation.
excerptis capped atexcerpt_max_chars(default 500, max 2000) so a caller never receives an unbounded body. Thetruncated: boolfield tells the caller whether the cap fired.Format.
formatis one of"markdown","html", or"text". The tool does not transcode between formats; what the upstream returned is what the tool returns, gated only by the include flag.No export.
allow_content_export: bool(defaultfalse) is a hard-stop on writing full text to disk or to a downstream store. Treat the body as in-memory-only; do not persist it.
The settings section (MEDIUM_MCP_* env vars, prefix-defined) carries
excerpt_max_chars, allow_content_export, monthly_budget, and the
rest. See settings/medium-mcp.yaml for the full list.
License
BSD-3-Clause.
Built on Oneiric for runtime configuration and mcp-common for the FastMCP baseline. Crackerjack gates every commit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search and read public data from X/Twitter, Reddit, YouTube, Instagram, TikTok, Facebook, Threads, Bluesky, Trustpilot, Amazon, Google Maps, news, forums and the web. 90+ read-only tools plus ready-made research playbooks (lead finding, brand monitoring, review mining). Hosted: connect with an API key; 50 free requests per endpoint each month.
Fetch any RSS/Atom feed as clean JSON or extract article text from any URL. Built for AI agents.
Read public X posts and full X Articles as clean Markdown. Free, no X API key.
Bluesky posts, profiles, feeds, threads & Substack newsletter search and publication feed MCP API.
41
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA browser-based solution that enables programmatic interaction with Medium's content ecosystem despite API deprecation, allowing publishing, retrieving, and searching Medium articles through Claude integration.12MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to publish posts to Medium with support for drafts, tags, canonical URLs, and follower notifications. Supports various publishing statuses and SEO optimization features.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Medium's platform for publishing, updating, and managing articles and drafts through OAuth 2.0 authentication with automatic retry logic and rate limit handling.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables programmatic interaction with Medium's content ecosystem for intelligent and context-aware content retrieval.29MIT