DevelopersMCP Agent Skill
MCP Agent Skill
Open-source agents need a small bootstrap so they know how to connect and which public REST-backed MCP tools to call. Do not package full schemas into the skill; the MCP tools mirror the public API endpoint schemas.
What Belongs In The Skill
| Include | Why |
|---|---|
| Endpoint and auth format | The agent has to connect before it can call tools |
| API key setup | The slim MCP tool surface calls the public REST API |
| Required scopes | Users can create the smallest useful key |
| Tool-to-endpoint map | Agents can reason from the public API contract |
| Safety rules | Prevent stale IDs and fake media-list, share-link, or send claims |
| Durable recipes | Give agents a small path through common tasks |
| Link to public docs | Humans need setup and troubleshooting context |
Skill Template
Save this as SKILL.md in the agent's skill/plugin format.
---
name: medialyst-mcp
description: Use when working with Medialyst through the remote MCP server. Helps agents search news, enrich journalists, check credit balance, and poll enrichment jobs.
---
# Medialyst MCP
Use the Medialyst MCP server when the user wants to search news, discover
journalists from recent coverage, enrich article authors, or check credit
balance.
## Connection
MCP endpoint:
```text
https://medialyst.ai/api/mcp
```
Send the user's Medialyst API key on every request:
```text
Authorization: Bearer <MEDIALYST_API_KEY>
```
Recommended scopes:
- `news:search`
- `media_lists:manage`
## Tool Surface
The MCP server is a thin shim over the public REST API:
- `get_credit_balance` -> `GET /api/v1/credits/balance`
- `search_news` -> `POST /api/v1/news/search`
- `enrich_journalists` -> `POST /api/v1/journalists/enrich`
- `get_journalist_enrichment_job` -> `GET /api/v1/journalist-enrichment-jobs/:jobId`
## Safety Rules
- Use real article URLs from `search_news` or the user when enriching
journalists.
- Use `fit_context.pitch` on `enrich_journalists` when the user wants scored
journalist fit or pitch angles.
- `enrich_journalists` is async-only. It returns a job id; poll
`get_journalist_enrichment_job` for completion.
- Do not use `options.wait` or `options.timeout_ms` on `enrich_journalists`.
They are deprecated compatibility no-ops.
- Use returned ids. Do not invent enrichment job ids.
- Do not claim the MCP can create media lists, read workflow rows, or create
share links.
- Do not claim the MCP can send outreach. Public v1 has no send endpoint.
- Keep API keys in environment variables or client secret storage. Never paste
raw keys into a prompt or commit them.
## Common Recipes
Find journalists from recent coverage:
1. `get_credit_balance`
2. `search_news` with a specific query and recency window
3. Select relevant article URLs
4. `enrich_journalists` with `fit_context.pitch`
5. Poll `get_journalist_enrichment_job` until the job is complete or failed
## Human Docs
Public docs:
```text
https://medialyst.ai/docs/developers/mcp
```Why This Stays Small
The skill is intentionally a bootstrap. If the public API adds endpoints or changes schemas, the MCP tool schemas should track the API contract and the skill should stay focused on connection, sequencing, and safety.