Mountaya Agent Skills

Reusable skills for AI agents to integrate with Mountaya products:

• Outdoor Intelligence (the Data API) → mountaya-data-api, mountaya-mcp
• Outdoor Tiles (the Tile API) → mountaya-tiles-api
• Map Embedding → mountaya-embedding

Full developer documentation lives at docs.mountaya.com.

Follows the Agent Skills Open Standard and works with Claude Code, Cursor, GitHub Copilot, Windsurf, Gemini CLI, and other compatible tools.

Install

Via skills CLI (recommended)

npx skills add mountayaapp/agent-skills

Or install specific skills:

npx skills add mountayaapp/agent-skills --skill mountaya-auth
npx skills add mountayaapp/agent-skills --skill mountaya-data-api
npx skills add mountayaapp/agent-skills --skill mountaya-tiles-api
npx skills add mountayaapp/agent-skills --skill mountaya-embedding
npx skills add mountayaapp/agent-skills --skill mountaya-mcp

Note: mountaya-data-api depends on mountaya-auth for session-token creation. If you install mountaya-data-api on its own, install mountaya-auth alongside it.

Manual installation

Claude Code

git clone https://github.com/mountayaapp/agent-skills.git
cp -r agent-skills/skills/mountaya-auth ~/.claude/skills/
cp -r agent-skills/skills/mountaya-data-api ~/.claude/skills/
cp -r agent-skills/skills/mountaya-tiles-api ~/.claude/skills/
cp -r agent-skills/skills/mountaya-embedding ~/.claude/skills/
cp -r agent-skills/skills/mountaya-mcp ~/.claude/skills/

Other tools

Copy the skill directories into your tool's skills folder.

Setup

Set your Mountaya API keys as environment variables so agents can authenticate:

export MOUNTAYA_PUBLISHABLE_KEY="pk_your_publishable_key"
export MOUNTAYA_SECRET_KEY="sk_your_secret_key"

Create keys in the Mountaya app: open your organization, then its API keys tab. Enable the scopes your products need: data for the Data API and the MCP server, tiles for the Tile API, embedding plus tiles for Map Embedding.

• Publishable key (pk_): identifies your organization. Required for all products.
• Secret key (sk_): creates session tokens for the Data API, and authenticates a non-interactive MCP client. Keep it server-side only.

Without these variables:

• Script-backed skills (mountaya-auth, mountaya-data-api) exit with a remediation message pointing at the API settings page.
• No-script skills (mountaya-tiles-api, mountaya-embedding, mountaya-mcp) emit example code with a pk_your_publishable_key placeholder and ask you to configure the key before running it.

mountaya-mcp needs no environment variables at all when an assistant connects over OAuth.

Skills

Skill	Product	Description
mountaya-auth	All products	API authentication (publishable keys, session tokens, rate limits, errors). Prerequisite for the others.
mountaya-data-api	Data API	GraphQL routing, places, and geospatial analysis (directions, suggestions, isochrones, matrices, geocoding, POIs, search). Requires mountaya-auth.
mountaya-tiles-api	Tile API	Tile rendering with MapLibre GL JS (overlays, itineraries, collections, zones).
mountaya-embedding	Map Embedding	Iframe integration (parameters, postMessage events, safety rules).
mountaya-mcp	MCP server	Connecting Claude, ChatGPT, Cursor, or VS Code to the read-only MCP server over OAuth or an API key pair.

Support

Found a bug or have feedback? Open an issue at github.com/mountayaapp/agent-skills/issues.

License

Repository licensed under the MIT License.