# GAMS Standards

> Open resource collections for the global asset management industry.

GAMS Standards (open.gamstandards.com) is a public repository of standardized templates, JSON schemas, reference documents, FAQs, and glossaries curated by industry working groups. All content is freely accessible without authentication.

## Getting Started

- Browse all collections: https://open.gamstandards.com
- Full catalog with API URLs: https://open.gamstandards.com/llms-full.txt
- MCP server: https://open.gamstandards.com/mcp

## AI-Optimized API Endpoints

These endpoints return clean, structured data designed for AI consumption.

### List All Collections
GET /api/ai/collections
Returns JSON array of all published collections with id, name, description, status, template_count, schema_count, and direct API URLs.

### Get Collection Detail (JSON)
GET /api/ai/collections/{collectionId}
Returns the full collection with all resources: templates (with download URLs), schemas (with parsed JSON Schema objects), references, FAQs, terms/glossary, and AI workflow hints.

### Get Collection Detail (Markdown)
GET /api/ai/collections/{collectionId}/markdown
Returns the full collection as a well-structured Markdown document including schema field tables, download links, and glossary. Best for web fetch tools that work with text.

### Get JSON Schema
GET /api/ai/collections/{collectionId}/schema/{schemaId}
Returns the parsed JSON Schema object directly (Content-Type: application/schema+json). Use this to understand the structured data format for extraction workflows.

### Download Template File
GET /api/collections/{collectionId}/templates/{templateId}/download
Returns the template file (Excel, PDF, Word, etc.) via redirect to a signed URL.

### Download Schema in Other Formats
GET /api/collections/{collectionId}/schemas/{schemaId}/download?format={format}
Supported formats: json, excel, xsd, proto, xbrl

### Download Reference Document
GET /api/collections/{collectionId}/references/{referenceId}/download
Returns the reference document via redirect to a signed URL.

## Content Negotiation

Collection pages support content negotiation via the Accept header:
- Accept: application/json -> returns AI-optimized JSON (same as /api/ai/collections/{id})
- Accept: text/markdown -> returns Markdown (same as /api/ai/collections/{id}/markdown)
- Default -> returns the HTML page

## MCP Server

An MCP (Model Context Protocol) server is available at https://open.gamstandards.com/mcp using Streamable HTTP transport. Connect to it from any MCP-compatible AI tool to access these tools:

- list_collections: Browse all available collections
- get_collection: Get full collection detail with all resources
- get_schema: Get a parsed JSON Schema definition
- get_schema_fields: Get a flattened table of all schema fields with types and constraints
- download_template_url: Get a download URL for a template file
- get_terms: Get glossary terms for a collection
- get_faqs: Get FAQ Q&A pairs for a collection
- search: Search across all resources

## Resource Naming

All resources use hierarchical names following AIP-122:
- collections/{collectionId}
- collections/{collectionId}/templates/{templateId}
- collections/{collectionId}/schemata/{schemaId}
- collections/{collectionId}/references/{referenceId}
- collections/{collectionId}/questions/{questionId}
- collections/{collectionId}/terms/{termId}

## Page Structure

Collection pages use anchor fragments for direct linking:
- #templates - Templates section
- #schemas - Data Schemas section
- #resources - References and Resources section
- #faqs - FAQ section
- #terms - Terms and Glossary section
- #template-{templateId} - Specific template
- #schema-{schemaId} - Specific schema

## Common Workflows

### Populate a template from a source document
1. Fetch the collection markdown: GET /api/ai/collections/{id}/markdown
2. Identify the target template and related schema from the markdown
3. Fetch the JSON Schema: GET /api/ai/collections/{id}/schema/{schemaId}
4. Use the schema fields, types, and constraints to guide extraction from your source document
5. Download the template file and populate it with the extracted data

### Extract structured data matching a schema
1. Fetch the JSON Schema: GET /api/ai/collections/{id}/schema/{schemaId}
2. Fetch glossary terms: GET /api/ai/collections/{id} (terms are included)
3. Extract data from your source document, producing JSON conforming to the schema
4. Validate against schema constraints (required fields, enums, patterns, formats)