Agent Integration Guide on SAM

Exposing Inference Services: OpenRouter

Mon, 01 Jan 0001 00:00:00 +0000

Exposing Inference Services: OpenRouter

In the Sovereign Agent Mesh (SAM), large language models (LLMs) and foundational model APIs are exposed across the mesh as Inference Services, not just standard Model Context Protocol (MCP) servers. This allows your deployed agents to dynamically discover, route, and consume inference capabilities directly through the P2P network, utilizing SAM’s decentralized authorization (Biscuit) for access control.

This guide explains how to expose OpenRouter as an inference service to the mesh, completely shielding your API keys from external peers.

Integrating SAM with Claude Code

Mon, 01 Jan 0001 00:00:00 +0000

You can connect your sam-node to Claude Code as a remote MCP server, giving Claude Code agents the ability to discover and invoke tools across the SAM mesh.

Overview

sam-node exposes a standard Model Context Protocol (MCP) server over HTTP Server-Sent Events (SSE). Claude Code is a generic MCP client, so once the server is registered its tools — discover_remote_services, find_remote_tools, describe_remote_tool, and call_remote_tool — are surfaced directly to your agent.

Integrating SAM with Claude Desktop

Mon, 01 Jan 0001 00:00:00 +0000

You can connect your sam-node to the Claude Desktop app as an MCP server. Unlike Claude Code, Claude Desktop has its own configuration and does not read Claude Code’s MCP settings.

Overview

Claude Desktop’s claude_desktop_config.json natively launches stdio MCP servers (a local command). sam-node exposes an SSE server, so you bridge the two with mcp-remote — a small stdio-to-remote proxy that Claude Desktop launches locally and that connects to your node’s SSE endpoint.

Integrating SAM with Google Antigravity

Mon, 01 Jan 0001 00:00:00 +0000

You can connect your sam-node to Google Antigravity as an MCP server. By exposing the SAM Model Context Protocol (MCP) server to Antigravity, the agent can dynamically discover tools hosted by other peers in the mesh, describe them, and execute them to solve tasks.

Overview

Antigravity natively supports Streamable HTTP MCP servers via the serverUrl configuration. Since sam-node implements the Streamable HTTP transport, you can connect it directly without any bridge.

Integrating SAM with OpenClaw

Mon, 01 Jan 0001 00:00:00 +0000

You can seamlessly integrate your sam-node as a remote MCP server in OpenClaw, allowing your agents to dynamically discover and invoke tools across the mesh.

Overview

By configuring your sam-node as an MCP server, you enable your OpenClaw agents to access the P2P mesh, discovering tools from remote nodes and executing services as if they were local.

Configuration

To bridge your local sam-node into your OpenClaw agent runtime, use the openclaw mcp CLI. Ensure your node is running and identify the API token configured in your sam-node launch arguments.

Running a Gemini AI Agent on the Mesh

Mon, 01 Jan 0001 00:00:00 +0000

This tutorial demonstrates how to connect a local AI Agent powered by Google Gemini (using the official google-genai SDK) to your local SAM node.

By exposing the SAM Model Context Protocol (MCP) server to Gemini, the agent can dynamically discover tools hosted by other peers in the mesh, describe them, and execute them to solve tasks.

Prerequisites

Python 3.10+: Ensure Python is installed on your host.
SAM Node Running: A local SAM node should be running and enrolled on the testnet (see the Quick Start Guide).
Gemini API Key: Obtain an API key from Google AI Studio and export it:
```
export GEMINI_API_KEY="your-api-key-here"
```

1. Setup the Python Client

Go to the sam-mcp-python directory in the repository: