AI Agent Gateway & Skills
Structured APIs, Model Context Protocol (MCP) server, and downloadable skill packages for AI agents.
Terms of Agentic Interaction (Version 2026-10-20)
Non-Exclusive Rights Disclosure: The site operator retains non-exclusive rights to all agentic interactions, including submitted content, generated outputs, and interaction records, to the extent the submitting party can grant those rights. Users retain their ownership and use rights.
Before executing privileged operations, agents must record explicit user delegation and acceptance of these versioned terms.
Operational Rules & Limits
- Caller Rate Limit: Ordinary callers share a single ceiling of 30 operations per rolling 60 seconds across all routes and API/MCP transports. Excess requests return HTTP 429 with
Retry-After. - Admin Exemption: Server-authenticated administrators are exempt from operation limits.
- Expiring Keys: All API keys and admin tokens expire within 7 days. The admin token is rotated every 6 days (518,400s) via local cron and monitored via tmux.
- Administrator Review: The first enrollment for any agent/user relationship requires explicit administrator review before key issuance. Keys are delivered only to verified HTTPS callbacks or email outbox.
- Vault Storage: Delivered keys must be stored in
agentsecwith a TTL matching remaining validity. Never hardcode keys in files or logs.
Downloadable Agent Skill Package
Contains complete versioned SKILL.md instructions and shell scripts for trail discovery, GPX submission, and status polling.
Package: urban-hiking.tar.gz (Version 1.0.0)
SHA-256 Digest: 97bf03f948a3809fbe40fe5b19b624c1fbf3add4d5441d7dcb47561924b53ea5
Platform Installation Prompts
Copy and send this instruction to your AI coding agent to install the skill package:
Antigravity CLI / IDE
Install the complete urban-hiking version 1.0.0 package from https://urban-hiking.pages.dev/skills/urban-hiking.tar.gz for Antigravity in $HOME/.gemini/antigravity-cli/skills/urban-hiking/. Verify the published SHA-256 97bf03f948a3809fbe40fe5b19b624c1fbf3add4d5441d7dcb47561924b53ea5, review the package, preserve existing custom skills, and load its SKILL.md and relevant references. Use the site's agentic API/MCP described at https://urban-hiking.pages.dev/.well-known/agent-interface.json to interact with Urban Hikes. Request only the permissions I authorize. Establish my delegation and obtain my acceptance of the versioned interaction terms if not already recorded. If this agent/user relationship has no approved grant, submit an application for administrator review and wait for approval before privileged operations. Use my approved HTTPS callback or verified email for key delivery. Store the delivered key privately in my agentsec vault in namespace repo:urban-trails, with TTL no greater than its remaining lifetime or seven days, and inject it only into the process making requests. Keep keys out of files, URLs, logs, and chat. Ordinary operations share 30 per rolling minute across every route and key; honor Retry-After. Authenticated admins have unlimited operations but their keys still expire within seven days. Explain pending approval or delivery status and never fabricate completed actions.
Claude Code
Install the complete urban-hiking version 1.0.0 package from https://urban-hiking.pages.dev/skills/urban-hiking.tar.gz for Claude Code in $HOME/.claude/skills/urban-hiking/. Verify the published SHA-256 97bf03f948a3809fbe40fe5b19b624c1fbf3add4d5441d7dcb47561924b53ea5, review the package, preserve existing custom skills, and load its SKILL.md. Use the site's agentic API/MCP described at https://urban-hiking.pages.dev/.well-known/agent-interface.json. Ordinary operations share 30 per rolling minute across every route.
Codex
Install the complete urban-hiking version 1.0.0 package from https://urban-hiking.pages.dev/skills/urban-hiking.tar.gz for Codex in $HOME/.agents/skills/urban-hiking/. Verify the published SHA-256 97bf03f948a3809fbe40fe5b19b624c1fbf3add4d5441d7dcb47561924b53ea5, review the package, preserve existing custom skills, and load its SKILL.md. Use the site's agentic API/MCP described at https://urban-hiking.pages.dev/.well-known/agent-interface.json.
Generic Agent Fallback
Fetch and extract https://urban-hiking.pages.dev/skills/urban-hiking.tar.gz. Verify SHA-256 97bf03f948a3809fbe40fe5b19b624c1fbf3add4d5441d7dcb47561924b53ea5. Read SKILL.md and inspect scripts/ for interacting with the Urban Hikes API and MCP endpoints at https://urban-hiking.pages.dev.
Model Context Protocol (MCP) Server
Connect your MCP-compatible client directly to:
Endpoint: https://urban-hiking.pages.dev/mcp
Method: POST
Headers: Content-Type: application/json, Authorization: Bearer <API_KEY_OR_ADMIN_TOKEN>
Available Tools: list_cities, search_walks, get_walk_details, accept_terms, enroll_agent, check_grant_status, submit_walk, submit_contact.