Thisispaper

Search 2,500+ hand-curated architecture, design, photography and art projects from Thisispaper. Returns a list of results with id, title and url.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search terms, e.g. 'concrete chapel' or 'art exhibitions'."
    }
  },
  "required": [
    "query"
  ]
}

Retrieve the full record for one Thisispaper project by id (the id returned by search). Returns title, text and the public url.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Project id from a search result, e.g. 'audeum-kengo-kuma'."
    }
  },
  "required": [
    "id"
  ]
}

Search 2,500+ hand-curated architecture, design, photography and art projects from Thisispaper. Returns ranked summaries (name, studio, city, year, category, intro, thumbnail, url, citation_url, provenance). Without an API key, results are capped at 5; pass Authorization: Bearer tip_live_... for full results.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search terms, e.g. 'concrete chapel' or 'japanese teahouse'."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10, max 20)."
    }
  },
  "required": [
    "query"
  ]
}

Nearest projects to a given slug by visual + semantic similarity (precomputed SigLIP neighbours). Use the slug from search_projects results.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Project slug, e.g. 'audeum-kengo-kuma'."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10, max 20)."
    }
  },
  "required": [
    "slug"
  ]
}

Full metadata for one project: machine-written description, design language, details and dimensions, plus the public URL.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Project slug, e.g. 'audeum-kengo-kuma'."
    }
  },
  "required": [
    "slug"
  ]
}

Search by taste metadata: material, light, color, mood, composition, subject. Unique to Thisispaper: these tags were written during human curation. Provide at least one dimension; results are ranked by how many dimensions match, then by recency.

{
  "type": "object",
  "properties": {
    "material": {
      "type": "string",
      "description": "Material, e.g. 'rammed earth', 'concrete', 'timber'."
    },
    "light": {
      "type": "string",
      "description": "Light quality, e.g. 'diffused', 'natural', 'dramatic'."
    },
    "color": {
      "type": "string",
      "description": "Palette, e.g. 'white', 'earth tones', 'green'."
    },
    "mood": {
      "type": "string",
      "description": "Mood, e.g. 'austere', 'warm', 'monumental'."
    },
    "composition": {
      "type": "string",
      "description": "Composition, e.g. 'symmetrical', 'geometric', 'minimal'."
    },
    "subject": {
      "type": "string",
      "description": "Subject, e.g. 'chapel', 'house', 'pavilion'."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10, max 20)."
    }
  }
}

Newest projects in the archive first, optionally filtered by category: architecture, interiors, design, photography or art.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Optional category filter: architecture, interiors, design, photography or art."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10, max 20)."
    }
  }
}

One project chosen at random from the archive. Editorial serendipity: the way a reader opens a magazine to an unplanned spread.

{
  "type": "object",
  "properties": {}
}

Every hand-curated Thisispaper guide and edition. Guides are places: Tokyo, Kyoto, Lisbon, Copenhagen. Editions are themes: Black Matter (black as a way of handling light), Jutaku (Japanese houses on narrow plots), Icons, Off-the-Grid, Monographs on single architects. Returns each one's title, type, one-line description, cover image and public URL. Filter by city or by type. The full guides and editions are reserved for Thisispaper+ members.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional city or region filter, e.g. 'tokyo' or 'portugal'. Applies to guides."
    },
    "type": {
      "type": "string",
      "enum": [
        "guide",
        "edition"
      ],
      "description": "Optional: 'guide' for places, 'edition' for themes. Omit for both."
    }
  }
}

Mint a FREE Thisispaper Intelligence API key (200 calls/month) for an email address. The key is shown once; use it as Authorization: Bearer tip_live_... on this MCP endpoint and on the REST API. Max 3 keys per email.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Your email address. The key is tied to it."
    }
  },
  "required": [
    "email"
  ]
}