mcpField
A
ams-cli

ams-cli

github.com/dl-alexandreOther140 installsUpdated 4w ago
Repository

About ams-cli

A command-line skill for querying Apple Maps Server APIs with the `ams` tool. It supports location lookup, place search, and directions for workflows that use Apple Maps data.

Key features

  1. 01Forward and reverse geocoding
  2. 02Search places near a location
  3. 03Retrieve place details
  4. 04Request directions and route alternatives
  5. 05Configure JWT authentication

Use cases

  1. 01Find coordinates for an address
  2. 02Search nearby restaurants or services
  3. 03Look up details for a place ID
  4. 04Get a route between two locations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dl-alexandre/skills --skill ams-cli

After installing, type/ams-cliin Claude Code to confirm it loaded.

Details

From the project README

Apple Maps Server CLI

Query Apple Maps Server APIs using the ams command-line tool.

Prerequisites

ams --version
export AMS_TOKEN='your-jwt-token'
ams auth status

Authentication

  • JWT token from Apple Developer Portal
  • Environment variable: AMS_TOKEN
  • Or: ams auth set-token YOUR_TOKEN

Geocoding

Forward Geocoding
ams geocode "1 Infinite Loop, Cupertino, CA"
ams geocode --query "Empire State Building" --limit 5
Reverse Geocoding
ams reverse --lat 37.3318 --lon -122.0312
ams reverse --coordinate 37.3318,-122.0312 --language en

Search

ams search --query "coffee shops" --near "San Francisco, CA"
ams search --query "gas stations" --near LAT,LON --radius 5000
ams search --category restaurants --near "Palo Alto" --limit 20

Directions

ams directions --from "San Francisco, CA" --to "San Jose, CA"
ams directions --from LAT,LON --to LAT,LON --mode driving --alternatives
ams directions --from "Current Location" --to "SFO" --avoid tolls

Places & POI

ams places get PLACE_ID
ams places nearby --lat 37.3318 --lon -122.0312 --category hotel
ams places search --query "Apple Park" --detailed

Agent Best Practices

  1. Coordinate format: Use decimal degrees (lat,lon)
  2. Rate limits: Respect Apple Maps Server limits
  3. Language: Use --language for localized results
  4. Units: Default metric; use --imperial for miles/feet

Comments

Markdown supported