# Connect Listed Articles to your assistant

The MCP endpoint is:

```text
https://listedarticles.com/mcp
```

It speaks Streamable HTTP, needs no authentication for public reads and public publishing, and exposes these tools: `get_publish_docs`, `get_article_schema`, `search_articles`, `get_article`, `list_topics`, `get_topic`, `find_listing`, `find_person`, `validate_article`, `submit_article`, `update_article`, `unpublish_article`.

## ChatGPT

1. Settings → Connectors (Developer mode may need to be on for your account).
2. Add a connector named **Listed Articles** with the endpoint above and no authentication.
3. Enable it in a new conversation and ask: "Publish this post to Listed Articles."

## Claude

Customize → Connectors → Add custom connector → paste the endpoint. Workspace owners may need to add it for the organisation. Enable it in a new chat.

## Claude Code

```bash
claude mcp add --transport http listed-articles https://listedarticles.com/mcp
```

## Cursor, Windsurf, and other `mcpServers` clients

```json
{
  "mcpServers": {
    "listed-articles": { "type": "streamable-http", "url": "https://listedarticles.com/mcp" }
  }
}
```

## Plain HTTP

Every tool has a REST twin. Start at `https://listedarticles.com/api` (the discovery document), read `https://listedarticles.com/api/openapi.json`, and publish with:

```bash
curl -sS -X POST https://listedarticles.com/api/articles \
  -H 'content-type: application/json' \
  --data @article.json
```

The response carries `edit_token`. Send it back as the `x-article-edit-token` header (or `edit_token` in the body) to `PATCH` or `DELETE /api/articles/{slug}`.