# Medium MCP

> Medium MCP lets your AI agent manage your entire publishing workflow. You can publish stories directly, audit all associated publications, and query contributor lists—all without opening a dashboard. It treats content distribution like a natural conversation with your writing team.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** blogging, publishing, content-creation, writing, audience-engagement, social-platform

## Description

This connector turns Medium into something far more than just a blogging platform; it makes it an operational hub for writers and editors. By connecting this MCP to Vinkius, you give your agent the ability to handle publishing tasks that used to require multiple manual logins and complex forms. Your agent can instantly list every publication you own or contribute to, grab detailed user information, and create entirely new posts tailored for specific audiences. When you're working on a high-traffic publication, this MCP acts like a real-time editorial assistant. It handles the technical formatting—whether you need Markdown or HTML—and ensures that content gets distributed exactly where it needs to go, whether that’s your profile or a dedicated section of a larger journal.

## Tools

### create_post
Publishes a brand-new article directly to your Medium profile feed.

### create_publication_post
Creates and publishes an article targeted under a specific, named publication.

### get_me
Retrieves your current user details and profile information from Medium.

### list_contributors
Fetches the list of all people who contribute to a specific publication.

### list_publications
Generates a complete list of every publication you are associated with on Medium.

## Prompt Examples

**Prompt:** 
```
Get my Medium user ID and publications.
```

**Response:** 
```
I've retrieved your profile. Your user ID is '12345' and you contribute to 2 publications: 'The Startup' and 'AI Trends'. Which one would you like to explore?
```

**Prompt:** 
```
Publish a draft titled 'My AI Story' with tags 'AI,Future'.
```

**Response:** 
```
Draft created! 'My AI Story' is now saved in your Medium account with 2 tags. You can review and publish it from your dashboard whenever you're ready.
```

**Prompt:** 
```
Who are the contributors for publication ID xxxx?
```

**Response:** 
```
I've found 3 contributors for that publication: 'Jane Doe', 'Marcus R.', and 'BotAssistant'. Would you like to see their profile URLs?
```

## Capabilities

### Audit all publications
Retrieve and list every publication associated with your Medium account.

### Check writing team membership
Query any specific publication to get a detailed roster of its contributors.

### Create standalone stories
Draft and publish new articles directly to your main profile feed.

### Targeted content publishing
Publish a story specifically under one of your existing publications, ensuring it reaches the right audience.

## Use Cases

### Updating the 'About Us' page for a new journal.
The editorial manager needs to verify all current writers. They ask their agent to run `list_contributors` for the main publication ID, quickly confirming that no team members were accidentally left off the roster.

### Batch publishing evergreen content.
A marketing team has 10 finished articles and needs them published immediately. They use `create_publication_post` in a loop, ensuring each piece lands under the correct publication with custom tags.

### Onboarding a new writer to the platform.
The content creator wants to show their agent all available publishing outlets. They call `list_publications`, getting a clean list they can use to write onboarding instructions for a new hire.

## Benefits

- You can instantly list all publications using the `list_publications` tool. You never have to remember which journal you contribute to; the agent handles that inventory check for you.
- When you write a story, you don't just publish it. You use `create_publication_post` to ensure the article lands exactly where your audience expects it, under the right publication banner.
- Need to verify who wrote what? The `list_contributors` tool gives you a clean roster of writers for any journal, so you always know who's on the team page.
- Forget formatting headaches. You can publish content using either HTML or Markdown formats, ensuring your aesthetic stays perfect regardless of how it gets exported.
- Start by calling `get_me` to pull your user data. This gives your agent a solid foundation of context before it starts drafting and publishing anything.

## How It Works

The bottom line is that once connected, you just talk to your agent; it handles the Medium details for you.

1. Subscribe to this MCP and provide your Medium Integration Token.
2. Connect it via your preferred AI client (Claude, Cursor, or any compatible agent).
3. Ask your agent to perform a publishing task, like listing publications or creating a post.

## Frequently Asked Questions

**How do I list all my publications using the Medium MCP?**
You run the `list_publications` tool. This command retrieves a comprehensive list of every publication you are associated with on your account, giving you immediate visibility into all your content destinations.

**Can I publish a story to only one specific journal?**
Yes, use the `create_publication_post` tool. This allows you to target your new article specifically under a named publication, ensuring it doesn't get lost on your main profile feed.

**What is the best way to check my user data?**
You should use `get_me`. Running this tool retrieves all necessary authenticated user details and confirms your current status, giving your agent a solid foundation for any publishing task.

**Does Medium MCP help me manage contributor lists?**
Absolutely. You can run the `list_contributors` tool to query any publication and get a clear roster of all contributors associated with it, making team management simple.