> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-for-blender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Poly Pizza Integration: Low-Poly Game Assets for Blender MCP

> Use Poly Pizza inside Blender MCP to access 10,600+ free low-poly models including the rescued Google Poly archive, ideal for stylised game scenes.

Poly Pizza hosts roughly 10,600 free low-poly models including the rescued Google Poly archive. Every model is a single self-contained .glb file with far lighter geometry than Sketchfab, making it the best source for stylised game assets and scenes that need many props without heavy meshes.

## Setup

Before you can use Poly Pizza assets, you need to configure your API key.

<Steps>
  <Step>
    Get a free API key at [poly.pizza/settings/api](https://poly.pizza/settings/api).
  </Step>

  <Step>
    In Blender, press **N** in the 3D viewport and open the **BlenderMCP** tab.
  </Step>

  <Step>
    Tick **Use Poly Pizza**.
  </Step>

  <Step>
    Paste your API key into the field.
  </Step>
</Steps>

To store the key permanently, go to **Edit → Preferences → Add-ons → Blender MCP** and enter it in the Poly Pizza API Key field. Alternatively, set the environment variable `BLENDERMCP_POLYPIZZA_API_KEY` before starting Blender.

## Searching and Filtering

Poly Pizza models can be filtered to narrow your search. The LLM can apply these filters automatically based on your prompt:

| Filter       | Options                                                                                                                                        |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Category** | Animals, Furniture & Decor, Transport, Nature, Buildings, People & Characters, Food & Drink, Weapons, Clutter, Objects, Scenes & Levels, Other |
| **Licence**  | `CC0` or `CC-BY`                                                                                                                               |
| **Animated** | `true` to show only animated models                                                                                                            |

## Attribution

About 69% of the Poly Pizza catalog is CC-BY, which requires crediting the creator. When a CC-BY model is imported, attribution is stored as a `polypizza_attribution` custom property on the imported objects. Filter with `licence="CC0"` to avoid attribution requirements entirely.

## Tools

Blender MCP exposes these Poly Pizza tools to the LLM:

| Tool                                                              | Purpose                                                    |
| ----------------------------------------------------------------- | ---------------------------------------------------------- |
| `get_polypizza_status()`                                          | Check if the API key is valid and the service is reachable |
| `search_polypizza_models(query, category, licence, animated)`     | Search the catalog with optional filters                   |
| `download_polypizza_model(model_id, normalize_size, target_size)` | Download and import a specific model                       |

<Tip>
  Always pass `normalize_size=True` and a real-world `target_size` in metres when downloading. Poly Pizza models come from the Google Poly archive with arbitrary scale, so without normalization they may appear extremely large or small.
</Tip>

## Example Prompts

* "Fill this room with low-poly furniture from Poly Pizza"
* "Search Poly Pizza for a low-poly chair under a CC0 licence and import one at 1 metre tall"
* "Add some stylised trees and rocks to the scene"