Content
# Thisispaper MCP
Thisispaper is an independent art, architecture and design publication. Every project in the archive was curated by human editors since 2011.
Search 2,500+ curated projects: search, visual similarity, and full project metadata with material, light, mood and composition tags written during curation. Free tier, no signup to try.
Contact: studio@thisispaper.com
- **Endpoint (Streamable HTTP, stateless):** `https://www.thisispaper.com/intelligence/api/mcp`
- **Docs:** [thisispaper.com/intelligence/api-docs](https://www.thisispaper.com/intelligence/api-docs)
- **Auth:** optional. Anonymous requests work out of the box (results capped at 5). A free self-serve key (200 calls/month) unlocks full results via `Authorization: Bearer tip_live_...`
## Tools
| Tool | What it does |
| --- | --- |
| `search` | ChatGPT-connector search: results with id, title, url |
| `fetch` | ChatGPT-connector fetch: one project, full record, embeds the real thumbnail image |
| `search_projects` | Ranked search across the archive: name, studio, city, year, category, intro, thumbnail, citation URL, provenance |
| `similar_projects` | Visually + semantically similar projects for a slug (precomputed SigLIP neighbours) |
| `get_project` | Full metadata for one project: description, design language, details, taste dimensions |
| `search_by_taste` | Search by curation-time taste tags: material, light, color, mood, composition, subject |
| `browse` | Newest projects, optionally by category (architecture, interiors, design, photography, art) |
| `discover` | One project at random: editorial serendipity as a tool |
| `get_api_key` | Mints a free API key (200 calls/month) for an email address |
Every project-shaped response carries `provenance` (curated by, selection date, in archive since) and a permanent `citation_url`.
## Install
### Cursor
[Add to Cursor](https://cursor.com/en/install-mcp?name=thisispaper&config=eyJ1cmwiOiJodHRwczovL3d3dy50aGlzaXNwYXBlci5jb20vaW50ZWxsaWdlbmNlL2FwaS9tY3AifQ%3D%3D)
Or add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"thisispaper": {
"url": "https://www.thisispaper.com/intelligence/api/mcp"
}
}
}
```
### Gemini CLI
```bash
gemini extensions install https://github.com/zaxarovcom/thisispaper-mcp
```
### Claude Code
```bash
claude mcp add --transport http thisispaper https://www.thisispaper.com/intelligence/api/mcp
```
### Claude.ai (custom connector)
Settings → Connectors → Add custom connector → URL: `https://www.thisispaper.com/intelligence/api/mcp`
### Any MCP client (generic)
Transport: Streamable HTTP. URL: `https://www.thisispaper.com/intelligence/api/mcp`. No OAuth. Optional header: `Authorization: Bearer tip_live_...`
## Getting a free key
Ask the agent to call `get_api_key` with your email, or use the [API docs page](https://www.thisispaper.com/intelligence/api-docs). 200 calls/month, no card.
## Try it
```
"Find concrete chapels in the Thisispaper archive"
"Show me projects similar to audeum-kengo-kuma"
"What materials define Japanese teahouse projects?"
"Find projects with rammed earth and dusk light"
```
## About
Thisispaper is an independent art, architecture and design publication. Every project in the archive was curated by human editors since 2011.
Contact: studio@thisispaper.com
