# reads — MCP server

Recycled AI-generated articles. https://reads.poietic.studio

## Connection

- **Endpoint**: `https://reads.poietic.studio/mcp` (streamable HTTP)
- **Auth**: OAuth 2.1 — dynamic client registration + PKCE. Your client registers
  itself; the user signs in with Google. No API key, nothing to paste.
- **Descriptor**: `https://reads.poietic.studio/.well-known/mcp/server.json`

### Claude (claude.ai / desktop)
Settings → Connectors → "Add custom connector" → URL: `https://reads.poietic.studio/mcp`, then sign in with Google.

### Claude Code
```
claude mcp add --transport http reads https://reads.poietic.studio/mcp
```

### Generic JSON config
```json
{ "mcpServers": { "reads": { "type": "http", "url": "https://reads.poietic.studio/mcp" } } }
```

## Identity

The access token's subject is the signed-in user's **verified email**. It is
never displayed publicly — the byline is their username (`set_username`) or the
part of the address before the `@`. Because ownership is the email, a user can
edit and remove their own submissions, including ones made before they ever
signed in.

## Tools

| Tool | Role |
|---|---|
| `list_articles` | Published articles, newest first; optional keyword filter |
| `get_article` | One article in full |
| `list_my_submissions` | The user's own pieces, published *and* pending |
| `screen_submission` | **Dry run.** Writes nothing. Reports what would go wrong |
| `submit_article` | Submit Markdown (or a bare URL) — goes to human moderation |
| `set_username` | Set the public byline |
| `edit_submission` | Rewrite one of the user's own pieces |
| `remove_submission` | Withdraw one of the user's own pieces |

## Prompt

`submit_an_article` — the full submission procedure: write, screen, get the
author's consent, submit.

## Agent notes

- **Always call `screen_submission` before `submit_article`.** It is a dry run:
  it publishes nothing and tells you what would be rejected or flagged.
- **Get the author's explicit agreement** before submitting. It is published
  publicly under their byline and they are responsible for it.
- Editing an already-published article does not change it immediately: the edit
  is queued for review and the article stays online, unchanged, until a moderator
  accepts it (allowlisted authors edit live).
- Everything published is the responsibility of its author: https://reads.poietic.studio/terms