Claude
Claude on the web, Desktop, and Cowork (Free, Pro, Max, Team, Enterprise).
- Open Settings → Connectors.
- Click Add custom connector.
- Paste the MCP server URL and click Add.
- Sign in with TruRating on the first secure request.
Connect an AI assistant (MCP)
This portal is also a Model Context Protocol (MCP) server, so AI assistants and editors can search and read the documentation directly. Public docs are available to anyone. Secure docs are split by section (In-Store, Online, Flex, Complementary, Truhub), so which secure docs you can reach depends on which sections your TruRating identity login has been granted — speak to TruRating to arrange or extend access. Ask the assistant to check check_docs_access to see what your connection currently has.
MCP server URL
https://docs.trurating.com/api/mcpOne-click for editors
VS Code and Cursor support one-click MCP install links. Click a button, confirm the prompt in your editor, then trigger a secure action to sign in with TruRating.
Add it to your assistant
Claude, ChatGPT, and Gemini each connect to the same MCP server URL. The exact menu differs per product:
ChatGPT
Custom connectors require Developer Mode, enabled by a workspace admin.
- Admin enables Settings → Connectors → Developer mode.
- Under Connectors, choose Create.
- Enter a name, description, and the MCP server URL.
- Authorize with TruRating when prompted.
Plus/Pro accounts are read-only; write actions need Business, Enterprise, or Edu.
Gemini
The consumer Gemini app has no MCP UI yet; use the CLI or Gemini Enterprise.
- Gemini CLI: add the server URL to
~/.gemini/settings.jsonundermcpServers. - Gemini Enterprise: an admin adds a custom MCP server data store in the Google Cloud console.
- Authorize with TruRating when prompted.
What the tools do
| Tool | Sign-in needed? | What it does |
|---|---|---|
list_doc_sections | No | Lists the public and secure section titles and paths. |
check_docs_access | No | Reports whether you're signed in and which secure sections (In-Store, Online, Flex, Complementary, Truhub) you can access. |
search_docs | Only for secure results | Full-text search across the documentation, secure results scoped to your sections. |
read_doc | Only for /secure/** pages, and only in sections you can access | Reads a single document as text. |
list_tsi_schema_versions | Yes, In-Store section | Lists available TSI schema versions (for example v250). |
get_tsi_schema_definition | Yes, In-Store section | Looks up a single TSI XSD element, complexType, or simpleType by name and returns its documentation, structure, and raw XSD. |
get_tsi_example_payload | Yes, In-Store section | Gets worked example TSI Request/Response XML payloads from the Message Cookbook for a given message type. |
validate_tsi_payload | Yes, In-Store section | Validates a TSI v2.5.0 payload against v250.xsd and returns friendly structural checks. |
generate_tsow_docx | Yes, In-Store section | Generates a draft Technical Scope of Work (.docx) from wizard answers, same as the interactive TSOW generator. |
generate_postman_collection | Yes, In-Store section | Generates a runnable TSI v2.5.0 Postman collection for a partner sandbox setup. |
estimate_tsi_bandwidth | Yes, In-Store section | Estimates monthly TSI question/rating traffic and bandwidth from transaction volume and response profile. |
contact_trurating | No | Sends a message to the TruRating developer team, for example to ask for help, report a docs issue, or request support. |
Troubleshooting
- Sign-in or authorization fails: you need a TruRating identity login with at least one documentation section role — speak to TruRating to arrange access. Without one, public docs still work but every secure tool call is refused.
- Some secure calls work but others are refused: your account only has access to some sections. Ask the assistant to call
check_docs_accessto see which ones, then speak to TruRating to request the rest. - "Couldn't connect": make sure you used the
https://URL above, exactly as shown. - Nothing appears after adding: remove and re-add the connector so the client re-runs discovery.
Still stuck? Contact your TruRating Solutions Architect.