thisispaper-mcp

# 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