← Back to Skills Marketplace
95
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install mapbox-mcp-runtime-patterns
Description
Integration patterns for Mapbox MCP Server in AI applications and agent frameworks. Covers runtime integration with pydantic-ai, mastra, LangChain, and custo...
Usage Guidance
This package appears to contain legitimate Mapbox MCP integration patterns and runnable examples, but there are a few mismatches and operational risks to consider before using it:
- Credentials: The manifest lists no required env vars, but examples and SKILL.md require MAPBOX_ACCESS_TOKEN (and many examples also reference OPENAI_API_KEY and HF_TOKEN). Do not run examples until you confirm which tokens are needed and provide them securely (use least-privilege tokens, rotate them, and avoid pasting long-lived secrets into shared shells).
- Running code from npm/npx: Self-hosting instructions use `npm install` / `npx @mapbox/mcp-server` and example code spawns child processes. `npx` will fetch and execute code from the npm registry; only run this in trusted environments and consider pinning package versions or using verified releases.
- Agent system prompts: Examples include system_prompt and prompt templates that control agent behavior. This is normal for agent integrations, but review them to ensure they don't grant the agent overly broad or unsafe instructions (especially if you plan to allow autonomous agent runs).
- Manifest/document mismatch: Ask the publisher to update registry metadata to declare required environment variables (MAPBOX_ACCESS_TOKEN and any LLM tokens used) so the skill's requirements are explicit.
- Operational safety: If you will self-host the MCP server, verify the `@mapbox/mcp-server` package integrity (use package-lock, pin versions, run in isolated environments / containers). If you only need hosted MCP, prefer using the documented hosted endpoint (https://mcp.mapbox.com/mcp) with a scoped token.
If you want, I can: (1) list exact files/lines that reference each token or npx usage, (2) suggest a minimal, safe checklist for running the examples in an isolated environment, or (3) draft questions to ask the skill author to clarify the missing metadata.
Capability Analysis
Type: OpenClaw Skill
Name: mapbox-mcp-runtime-patterns
Version: 1.0.0
The skill bundle provides legitimate integration patterns and code examples for the Mapbox MCP Server across various AI frameworks, including Pydantic AI, CrewAI, LangChain, and Mastra. The code correctly implements tool calling via the official Mapbox hosted endpoints (mcp.mapbox.com) and provides standard patterns for local execution using npx. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the instructions and code logic are entirely consistent with the stated purpose of providing geospatial capabilities to AI agents.
Capability Assessment
Purpose & Capability
The name/description and the included example code all focus on integrating Mapbox MCP Server into agents (pydantic-ai, LangChain, Mastra, smolagents, CrewAI). That capability is coherent with the stated purpose. However, the registry metadata declares no required environment variables or primary credential even though the SKILL.md and examples clearly require MAPBOX_ACCESS_TOKEN (and sample workflows also reference OPENAI_API_KEY and HF_TOKEN). The omission of required env vars in metadata is an inconsistency.
Instruction Scope
SKILL.md and example files instruct running either the hosted MCP endpoint or self-hosting via `npm install` / `npx @mapbox/mcp-server`, and multiple code examples spawn child processes (subprocess.Popen, spawn) and write to process stdin/stdout. Those runtime actions are within the general scope of self-hosting MCP, but they allow executing code fetched from npm at runtime and give the agent/installer the option to run arbitrary packages. The instructions also embed system prompts (e.g., agent system_prompt strings) which can change agent behavior — expected for agent patterns but flagged by the pre-scan as a prompt-injection signal.
Install Mechanism
There is no install spec in the registry (instruction-only), which is low-risk by itself. However, the documentation and examples rely on npm/npx to install or run `@mapbox/mcp-server` (and suggest `npm install` in TypeScript examples). Running `npx` will fetch and execute code from the npm registry at runtime — a legitimate self-host option but a higher-risk install pattern if used without verification. No downloads from unknown hosts or URL shorteners are present; the hosted endpoint references mapbox.com.
Credentials
The skill declares no required env vars or primary credential, but SKILL.md and multiple examples clearly require MAPBOX_ACCESS_TOKEN for MCP and also reference OPENAI_API_KEY and HF_TOKEN in examples. Requiring API tokens for Mapbox (and optionally LLM/HuggingFace keys in examples) is expected for the stated purpose — but the metadata failing to declare these credentials is an incoherence and increases the chance a user will run examples without realizing sensitive tokens are required. Ensure tokens are provided with least privilege and not hard-coded.
Persistence & Privilege
always:false and normal model invocation semantics. The skill does not request forced persistence or system-wide configuration changes in the manifest. Example code starts local processes (self-hosting) but does not attempt to modify other skills' configurations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mapbox-mcp-runtime-patterns - After installation, invoke the skill by name or use
/mapbox-mcp-runtime-patterns - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of mapbox-mcp-runtime-patterns skill.
- Provides integration patterns for Mapbox MCP Server with popular AI frameworks including pydantic-ai, mastra, LangChain, and custom agents.
- Explains distinctions between offline geospatial tools and Mapbox API-powered tools, with usage guidance.
- Details best practices for cost, performance, and security in production AI applications.
- Includes references for setup (hosted/self-hosted), and pointers to detailed integration guides for various agent frameworks.
- Ideal for teams building AI-powered apps that require geospatial capabilities.
Metadata
Frequently Asked Questions
What is Mapbox MCP Runtime Patterns?
Integration patterns for Mapbox MCP Server in AI applications and agent frameworks. Covers runtime integration with pydantic-ai, mastra, LangChain, and custo... It is an AI Agent Skill for Claude Code / OpenClaw, with 95 downloads so far.
How do I install Mapbox MCP Runtime Patterns?
Run "/install mapbox-mcp-runtime-patterns" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mapbox MCP Runtime Patterns free?
Yes, Mapbox MCP Runtime Patterns is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Mapbox MCP Runtime Patterns support?
Mapbox MCP Runtime Patterns is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mapbox MCP Runtime Patterns?
It is built and maintained by Mapbox (@mapbox); the current version is v1.0.0.
More Skills