The official Model Context Protocol server for Outerview. It gives an MCP host one focused tool for streaming visual observations of the physical world: places, objects, conditions, and interactive captures.

Website: outerview.ai
Documentation: outerview.ai/docs
Developer setup and billing: outerview.ai/developers

Install

npm install -g @outerview/mcp

Create an Outerview API key, then provide it only to the MCP server process:

export OUTERVIEW_API_KEY="ov_your_key"
outerview-mcp

For PowerShell:

$env:OUTERVIEW_API_KEY = "ov_your_key"
outerview-mcp

Configure an MCP host

Use the outerview-mcp command as a stdio server. A typical host entry looks like this:

{
  "mcpServers": {
    "outerview": {
      "command": "outerview-mcp",
      "env": { "OUTERVIEW_API_KEY": "ov_your_key" }
    }
  }
}

Tool: `stream_world`

The server exposes stream_world.

Input	Required	Description
`query`	Yes	A description of what to find in real-world visual data.
`limit`	No	Result count, constrained by the API key's plan.
`position`	No	`{ points: [{ latitude, longitude }, ...] }`. Multiple points filter the global namespace to their H3 resolution-5 cells; the object is reserved for future line strings.
`interactive`	No	Set `true` to return only interactive results.

Example prompt for an MCP client: “Stream protected bike lanes in Montreal and return 25 results.” For immersive capture work: “Find interactive waterfront paths in Chicago.”

For coordinate-scoped work, pass position as { "points": [{ "latitude": 40.7128, "longitude": -74.0060 }, { "latitude": 40.7306, "longitude": -73.9866 }] }.

Results and access

The tool returns the raw Outerview JSON payload so an agent can inspect the GeoJSON features, dates, location geometry, and result properties. Video access is limited to Pro and Scale API keys. Use interactive: true before asking a client to render an interactive view.

Environments and limits

Set OUTERVIEW_BASE_URL to use a compatible development endpoint; otherwise the server calls https://api.outerview.ai. Free allows 5 RPM and 5 results; Starter allows 500 RPM and 50 results; Pro allows 2,000 RPM and 50 results; Scale allows 8,000 RPM and 200 results. See billing documentation.