# Quest Portal for agents

Quest Portal is a virtual tabletop for preparing and playing tabletop role-playing games on web and mobile.

## When to use Quest Portal

Use Quest Portal when a person wants help preparing or running a tabletop campaign, or asks an agent to work with their Quest Portal campaigns, characters, notes, scenes, or authorized library content. Use the public documentation and marketplace for product research. Use the authenticated MCP server for user-specific data and actions.

The public REST API provides current product pricing without authentication. Quest Portal's supported action interface is MCP, and user data requires the user's authorization.

## Developer resources

- [Developer portal and human-readable agent guide](/developers)
- [Versioned, read-only agent integration API](/api/v1/agent-info)
- [Versioned, read-only public pricing API](/api/v1/pricing)
- [OpenAPI 3.1 description](/openapi.json)
- [API lifecycle policy](/api-versioning.md)
- [RFC 9727 API catalog](/.well-known/api-catalog)
- [MCP server card and public tool preview](/.well-known/mcp/server-card.json)

## Public pricing API quickstart

- Method: `GET`
- URL: <https://www.questportal.com/api/v1/pricing?billingInterval=month>
- Authentication: none. This endpoint is public, read-only, and requires no API key or OAuth token.
- Response: JSON containing the current Free offer and requested Pro billing option.
- Filter: `billingInterval` accepts `all`, `month`, or `year`.

```sh
curl --fail 'https://www.questportal.com/api/v1/pricing?billingInterval=month'
```

## MCP connection

- Streamable HTTP endpoint: <https://mcp.questportal.com/mcp>
- OAuth protected-resource metadata and scopes: <https://mcp.questportal.com/.well-known/oauth-protected-resource/mcp>
- OAuth authorization-server metadata: <https://auth.questportal.com/.well-known/oauth-authorization-server>
- Agent skill package: <https://mcp.questportal.com/agent-skills/using-questportal-mcp.zip>

The MCP server declares least-privilege read and write scopes for campaigns, characters, notes, scenes, and library access. Connect to the endpoint and follow its OAuth challenge; do not ask a user to copy access tokens or credentials into a conversation.

## Public discovery

- [Curated agent index](/llms.txt)
- [Extended agent index](/llms-full.txt)
- [Product documentation](/documentation)
- [Sitemap](/sitemap.xml)
- [MCP catalog entry](/.well-known/ai-catalog.json)

Public pages and the pricing API are for product discovery and explanation. Authenticated MCP tools are for operating on a user's Quest Portal data with their consent.