Workflows

Create a style conversationally:

The AI will use create_style_tool tool to:

• Generate style JSON following Mapbox Style Spec
• Upload to your Mapbox account
• Return style ID and preview URL

Update existing style:

Validate style:

2. Token Management

Create scoped token:

List existing tokens:

Use case: Generate tokens for different environments (development, staging, production) with appropriate restrictions.

3. Data Validation

Validate GeoJSON:

Validate expressions:

Coordinate conversion:

4. Documentation Access

Get style spec info:

Check token scopes:

Streets v8 fields:

Best Practices

Security

• Never commit access tokens - Use environment variables
• Use scoped tokens - Minimal necessary permissions
• Add URL restrictions - Limit to your domains
• Rotate tokens regularly - Generate new tokens periodically

Style Management

• Version your styles - Save JSON to source control
• Use meaningful names - prod-light-mode not style-123
• Document decisions - Add comments explaining style choices
• Preview before deploying - Always check preview URL

Validation

• Validate early - Check data before creating styles
• Use strict validation - Don’t skip validation steps
• Test expressions - Validate before adding to styles
• Verify coordinates - Ensure correct format and bounds

Documentation

• Ask specific questions - “What are fill-extrusion properties?”
• Reference versions - Specify GL JS version if relevant
• Cross-reference - Validate AI responses against official docs