How to Use the Upstream Lens MCP in Claude Code

Q: How do I automate project monitoring with Upstream Lens and Claude Code?

Set up a shell script that calls listprojectobservations via the MCP Server. The output can be piped directly into an analysis tool, giving you automated field reporting without manual intervention.

Q: Can I use Upstream Lens with Claude Code to validate project notes?

Yes. Your script calls listprojectnotes and uses the date-filtering capabilities to pull reports for a specific time window, perfect for auditing purposes.

Q: If I need property imagery data, what does Upstream Lens provide to Claude Code?

The MCP Server provides listpropertyimagery. You can write a script that iterates through properties and fetches the available layer list for documentation purposes.

Q: How do I use Upstream Lens with Claude Code for initial setup checks?

Before deploying, run checkapihealth from your container. This confirms the MCP Server is reachable and ready to accept commands in the headless environment.

Q: What type of data does this MCP Server touch regarding project notes?

It touches textual and date-stamped records via listprojectnotes. Your scripts will process these notes, which are critical for maintaining an auditable history of the operational site.

Automate energy reporting and validation with Upstream Lens using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Upstream Lens MCP to Claude Code

Create your Vinkius account to connect Upstream Lens to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Upstream Lens with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Running Scheduled Project Checks with Claude Code

Schedule a nightly job to get all environmental projects. You run `list_projects` in your cron job, piping the output into a validation script that checks for required metadata. The MCP Server allows you to pull detailed observations using `list_project_observations`, making it ideal for nightly compliance reporting.

Data Integrity Checks with Claude Code

Run a health check before any pipeline executes. A simple call to `check_api_health` validates the connection status of the MCP Server, preventing failed deployments. You can also validate asset details by running `get_property_details` against known property IDs in your CI/CD script.

Generating Reports on Assets with Claude Code

Want to list all available investment buckets? Run `list_portfolios` and process the resulting JSON array. This is perfect for generating quarterly reports that summarize asset groupings. The agent also lets you pull key organizational identifiers using `get_organization_info`, which ensures your scripts always use the correct company scope.

Setup guide

Set up Upstream Lens MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see upstream-lens-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Upstream Lens transactions." It will automatically discover and invoke the available Upstream Lens tools.

Terminal

claude mcp add --transport http upstream-lens-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Upstream Lens MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "upstream-lens-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Upstream Lens. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Upstream Lens now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Upstream Lens MCP in Claude Code

Set up a shell script that calls `list_project_observations` via the MCP Server. The output can be piped directly into an analysis tool, giving you automated field reporting without manual intervention.

Yes. Your script calls `list_project_notes` and uses the date-filtering capabilities to pull reports for a specific time window, perfect for auditing purposes.

The MCP Server provides `list_property_imagery`. You can write a script that iterates through properties and fetches the available layer list for documentation purposes.

Before deploying, run `check_api_health` from your container. This confirms the MCP Server is reachable and ready to accept commands in the headless environment.

It touches textual and date-stamped records via `list_project_notes`. Your scripts will process these notes, which are critical for maintaining an auditable history of the operational site.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript