MCP Server

Connect Claude, ChatGPT, Cursor, and any other MCP client to your Raster libraries over the Model Context Protocol.

The Raster MCP server is a remote Model Context Protocol endpoint that lets any MCP-capable client (Claude, ChatGPT, Cursor, VS Code, and others) browse, upload, organize, and delete assets in your libraries without client-side code. It accepts two credentials:

OAuth, recommended for human-driven clients. You sign in and grant the connection one organization, or all of yours when the client requests it.
An organization API key sent as an Authorization: Bearer token. These are the same keys the REST API uses.

The MCP server is in Beta. Tools, arguments, and behavior are stabilizing but may still change before GA. Tool payloads track the REST API, so follow the REST changelog for wire-shape changes.

The endpoint

https://mcp.raster.app/

Detail	Value
Transport	Streamable HTTP (JSON-RPC over `POST`)
Auth	OAuth, or `Authorization: Bearer <API_KEY>`

Every request must be authenticated. Missing or malformed credentials are rejected with 401. See Authentication for how to sign in with OAuth or create and scope an API key.

Agents with no Raster account start at the no-account endpoint https://mcp.raster.app/anonymous, which mints an organization and key over create_organization. See Authentication.

Connect Raster

Connect Raster to your MCP client over OAuth. Pick your client below for a connect button or short setup steps, then a Raster sign-in where you grant the connection one organization, or all of yours when the client requests it:

Add a remote MCP server with this URL:

https://mcp.raster.app/

Claude Desktop: Settings → Connectors → Add custom connector, then paste the URL.

Claude Code: Run claude mcp add --transport http raster with the URL.

Then approve the Raster sign-in and choose which organizations the connection may access.

The client runs the MCP initialize handshake automatically and Raster's tools appear in its tool palette. Manage and revoke every connection under Profile settings → Connected apps. For the OAuth flow, scopes, and discovery endpoints, see Authentication.

To have your agent add it, paste this prompt:

Add the Raster MCP server to this client: a remote Streamable HTTP server named "raster" at https://mcp.raster.app/ over OAuth. Then walk me through the OAuth sign-in for this client (reload it if needed, approve in the browser) and confirm its tools load.

Server-to-server with an API key

For automation, point any client at https://mcp.raster.app/ over the Streamable HTTP transport with a Bearer Authorization header carrying an organization API key. These are the same keys, with the same per-library access, that you use for the REST API. See Authentication to create one.

{
  "mcpServers": {
    "raster": {
      "url": "https://mcp.raster.app/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Tools at a glance

Raster's tools cover the same surface as the REST API, including the no-account flow that agents use to create a library and start uploading on a user's behalf. Full parameters and examples are on the Tools page.

Tool	Access	Purpose
`whoami`	Read	Resolve the organizations and libraries your credential can act on.
`create_organization`	Anonymous	Create an organization, library, and API key for an agent, with no account needed.
`create_library`	Write	Create a library in an existing organization.
`rename_library`	Write	Rename a library.
`list_libraries`	Read	List libraries in an organization.
`list_assets`	Read	List assets in a library (paginated, tag filter).
`get_asset`	Read	Get one asset by id.
`search_assets`	Read	Search assets across libraries (ranked, highlights).
`list_tags`	Read	List a library's tags, by usage count.
`upload_asset`	Write	Upload one file from a URL or inline base64.
`upload_assets`	Write	Upload up to 20 files in one call.
`delete_assets`	Write	Move up to 100 assets to trash (soft delete).
`tag_assets`	Write	Apply up to 20 tags to up to 100 assets.
`untag_assets`	Write	Remove up to 20 tags from up to 100 assets.
`update_asset_description`	Write	Replace one asset's description (verbatim).
`set_asset_approval`	Read	Set one asset's approval state (OAuth connections only).
`transfer_assets`	Write	Move up to 100 assets between libraries.
`promote_variant`	Write	Make a variant the asset's default, at the asset's existing URL.

The endpoint

Connect Raster

Server-to-server with an API key

Tools at a glance

Where to go next

Authentication

Tools

Resources

Errors

Need help?

On this page