thisispaper-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Thisispaper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+Note: this license covers the integration manifests and documentation in this
+repository only. The Thisispaper editorial archive and API content remain the
+property of Thisispaper and are governed by the API terms at
+https://www.thisispaper.com/intelligence/api-docs
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# Thisispaper MCP
+
+Search 2,500+ curated architecture, design, photography and art projects. Fifteen years of human curation, structured for agents: search, visual similarity, and full project metadata with material, light, mood and composition tags. Free tier, no signup to try.
+
+- **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_projects` | Ranked search across the archive: name, studio, city, year, category, intro, thumbnail, URL |
+| `similar_projects` | Visually + semantically similar projects for a slug (precomputed SigLIP neighbours) |
+| `get_project` | Full metadata for one project: description, design language, details, dimensions |
+| `get_api_key` | Mints a free API key (200 calls/month) for an email address |
+
+## 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?"
+```
+
+## About
+
+[Thisispaper](https://www.thisispaper.com) is an independent architecture and design publication. Every project in the archive was selected by human editors since 2011.
+
+Contact: alexander@thisispaper.com

package/bin/thisispaper-mcp.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+// Thisispaper MCP — stdio wrapper around the remote Streamable HTTP endpoint.
+// Docs: https://www.thisispaper.com/intelligence/api-docs
+// Endpoint: https://www.thisispaper.com/intelligence/api/mcp
+//
+// This simply execs `npx -y mcp-remote <endpoint>` so any stdio-only MCP
+// client can talk to the hosted server. Extra CLI args are passed through
+// (e.g. --header "Authorization: Bearer tip_live_...").
+
+import { spawn } from "node:child_process";
+
+const ENDPOINT = "https://www.thisispaper.com/intelligence/api/mcp";
+const args = ["-y", "mcp-remote", ENDPOINT, ...process.argv.slice(2)];
+const cmd = process.platform === "win32" ? "npx.cmd" : "npx";
+
+const child = spawn(cmd, args, { stdio: "inherit" });
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  process.exit(code ?? 0);
+});
+child.on("error", (err) => {
+  console.error(`thisispaper-mcp: failed to launch mcp-remote via npx: ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "thisispaper-mcp",
+  "version": "1.0.0",
+  "description": "Search 2,500+ curated architecture, design, photography and art projects. Fifteen years of human curation, structured for agents: search, visual similarity, and full project metadata with material, light, mood and composition tags. Free tier, no signup to try.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "architecture",
+    "design",
+    "photography",
+    "art",
+    "thisispaper",
+    "api",
+    "search"
+  ],
+  "homepage": "https://www.thisispaper.com/intelligence/api-docs",
+  "bugs": {
+    "url": "https://github.com/zaxarovcom/thisispaper-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zaxarovcom/thisispaper-mcp.git"
+  },
+  "license": "MIT",
+  "author": "Thisispaper <alexander@thisispaper.com> (https://www.thisispaper.com)",
+  "type": "module",
+  "bin": {
+    "thisispaper-mcp": "bin/thisispaper-mcp.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}