# Backstage MCP server

> Exposes the Backstage Software Catalog API as tools for LLMs to perform entity discovery, catalog operations, and validation.

- Repository: https://github.com/Coderrob/backstage-mcp-server
- Page: https://hostedmcp.org/servers/coderrob/backstage-mcp-server
- Transport: —
- Stars: 3
- License: GPL-3.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BACKSTAGE_BASE_URL` | no | no |  |
| `BACKSTAGE_TOKEN` | no | no |  |
| `BACKSTAGE_TOKEN_FILE` | no | no |  |

## FAQ

### How do I configure authentication for the Backstage server?

You can provide a bearer token via the BACKSTAGE_TOKEN environment variable or point to a token file using BACKSTAGE_TOKEN_FILE.

### What kind of catalog operations can the AI perform?

The server provides tools for entity discovery, location discovery, entity validation, and catalog mutations such as adding, refreshing, or removing entities and locations.

### Can I use this server with a real Backstage deployment?

Yes, you can perform a read-only check against a real deployment using the test:live command.

### What are the system requirements for installation?

You need Node.js version 24.15 or newer and Corepack installed.
