# Socramed

> Socramed: medical notes mapped by specialty and topic, with occasional writing.

socramed.com is Socramed: a Medical Notes library, organised by specialty and topic, plus occasional personal writing. English lives at the root and Persian under /fa/.

## Languages

- English (default): https://socramed.com/
- Persian (فارسی): https://socramed.com/fa/

## Sections

- [Posts (Persian)](https://socramed.com/fa/posts/) — نوشته‌های شخصی; personal writing is currently in Persian only
- [Posts](https://socramed.com/posts/) — English personal writing, when published
- [Medical Notes](https://socramed.com/notes/) — public medical study notes by specialty (English)
- [Medical Notes (Persian)](https://socramed.com/fa/notes/) — یادداشت‌های پزشکی
- [About](https://socramed.com/about/)
- [Search](https://socramed.com/search/)
- [Cards](https://socramed.com/cards/index.json) — index of Cards: short typed reference cards (terms, stagings, scores, criteria, signs, drugs, organisms, formulas, abbreviations), English only; each card's full data is at /cards/data/<id>.json and its page, when it has one, at /cards/<type>/<id>/

## Key documents

- [Sitemap](https://socramed.com/sitemap-index.xml)
- [llms-full.txt](https://socramed.com/llms-full.txt) — index of full-text files, one per section, language and specialty
- [corpus.json](https://socramed.com/corpus.json) — machine-readable corpus manifest (schema 3): release hash and one entry per shard; each shard under `/corpus/` lists its documents, and each document under `/corpus/docs/` holds one post or note with its full text
- [cards/index.json](https://socramed.com/cards/index.json) — machine-readable Cards index (schema 1, its own content hash, not part of corpus.json); one data file per card under /cards/data/

## Notes for agents

- Content is original writing published openly by Socramed. Search indexing, AI answer grounding, and AI training are all permitted (permissive content signals in robots.txt).
- Every document is available in English (en) and/or Persian (fa, right-to-left). Persian pages live under /fa/.
- Medical Notes are organized by specialty under /notes/<specialty>/ and /fa/notes/<specialty>/.
- For full text, start at llms-full.txt and fetch only the section or specialty file you need; for one document, use the MCP get_article tool.
- A read-only MCP server is available at /mcp (streamable HTTP, no authentication) with search, article, recent, tag, and specialty tools; see /.well-known/mcp/server-card.json for its tool catalog.
- To read one card by its permanent id, fetch /cards/data/<id>.json. Cards are separate from corpus.json, llms-full and /mcp.