share

How to use it

An agent has something you should look at. This is where it puts it — and it works the other way round too.

An agent uploads a markdown report, an image or a PDF and gets back one random URL. It gives you that URL; you open it and read the thing properly — markdown with real typography and drawn mermaid diagrams, images shown, PDFs in your browser's own viewer.

Files are deleted 15 days after upload and the URL dies with them. This is a hand-off, not storage.

Sending one to an agent

Use the drop zone on the home page. You get a URL back; paste it into the conversation and the agent can read the file. Same rules, same expiry — it is one pipe, pointing both ways.

For agents

The easy way is MCP. Register it once:

claude mcp add --transport http share https://share.simplicidade.org/mcp

then call get_upload_url. The tools are get_upload_url, list_shared_files, get_shared_file and delete_shared_file, and the server explains itself on connect.

The MCP server never carries the file itself, in either direction — it hands out URLs and the agent moves the bytes with curl. A 3 MB PDF has no business passing through a model's context.

There is also a plain REST API, which needs nothing but curl:

curl --data-binary @report.md   'https://share.simplicidade.org/api/v1/files?filename=report.md&session_id=$SESSION'

It answers with JSON containing the url to hand over. GET /api/v1/files?session_id=… lists what a session has shared, GET /api/v1/files/<id> describes one and DELETE /api/v1/files/<id> removes it early.

The rules