# Quest Portal for agents

## Browser tools (WebMCP)

In a WebMCP-enabled browser, visit this site and discover tools with `document.modelContext.getTools()`. The current integration targets the evolving W3C draft, verified September 8, 2026. See [browser setup](https://developer.chrome.com/docs/ai/webmcp).

Start with `questportal_site_directory`. Use `questportal_search_site` for public content titles and descriptions, `questportal_navigate` to visit a result, `questportal_read_page` to read it, and `questportal_get_pricing` for current offers. Page-specific tools follow navigation:

- / and /assistant: inspect and prepare campaign setup, then explicitly continue to the app.
- /marketplace: search published products.
- /characters: search and paginate public portraits, open a result, customize and download its token.
- /character-sheets: search character sheet templates; individual template pages expose local preview tools.
- /pricing: inspect the visible prices and select monthly or annual billing.
- /love: inspect and apply testimonial filters.
- /tools/npc-generator: generate an NPC through the annotated form; read and edit its local notes through imperative tools.
- /roll: roll bounded dice groups and read the same result shown on the page.
- /trivia and its game/topic pages: start rounds, read the current question, answer, and restart.
- /personality: read the current question, answer, go back, and restart.

Follow each tool's schema and current-question/preparation guards. Local edits and quiz progress may be lost when leaving a page. WebMCP does not grant account access, purchase products, start paid generation, or bypass third-party checkout. For user-owned data, connect to the authenticated MCP server. Browsers without WebMCP can use the normal site and public HTTP resources.


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>
- User setup guide for Claude, ChatGPT, Codex, and other MCP clients: <https://www.questportal.com/mcp>

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.