Offline Protocol (hosted)

Official15 tools

by Offline-Protocol

Offline Protocol packages, workflows and integration guides over HTTPS. Read-only.

com.offlineprotocol/hosted Model Context Protocol (MCP) Server

The com.offlineprotocol/hosted MCP server provides access to “Offline Protocol” packages, workflows, and integration guides over HTTPS. It is read-only, exposing documentation and related resources suitable for developers who want to reference offline protocol materials via MCP.

🛠️ Key Features

Offline Protocol packages
Offline Protocol workflows
Offline Protocol integration guides
Access via HTTPS
Read-only access

🚀 Use Cases

Referencing Offline Protocol packages
Reviewing Offline Protocol workflows
Consulting Offline Protocol integration guides
Using HTTPS-hosted documentation through MCP

⚡ Developer Benefits

Consistent HTTPS-based access to offline protocol resources
Read-only retrieval for safer consumption of guides and workflows

⚠️ Limitations

Read-only: no updates or publishing actions

Topics

claude-codecodexcursorgemini-cligemini-cli-extensionmcpoffline-protocol

Captured live from the server via tools/list.

list_packages

List every Offline Protocol SDK package in the public registry with its version, supported platforms, capabilities and license.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_package

Get one Offline Protocol package's registry entry: capabilities, peer dependencies, platform requirements, integration notes and examples.

Parameters1

name

string

required

Package name, e.g. @offline-protocol/mesh-sdk

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Package name, e.g. @offline-protocol/mesh-sdk",
      "maxLength": 128
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

search_packages

Search Offline Protocol SDK packages by name, capability or description keywords. Returns ranked matches.

Parameters1

query

string

required

Search keywords

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keywords",
      "maxLength": 200
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

search_capabilities

Search Offline Protocol capabilities, such as peer discovery or encrypted groups, and see which packages, workflows and guides provide each one.

Parameters1

query

string

required

Search keywords

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keywords",
      "maxLength": 200
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

search_workflows

Search Offline Protocol product workflows, such as local handoff, nearby chat, backend delivery or OfflineID sign-in, by keywords describing what you want to build.

Parameters1

query

string

required

Search keywords

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keywords",
      "maxLength": 200
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

search_examples

Search Offline Protocol reference example apps and integrations by keyword.

Parameters1

query

string

required

Search keywords

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keywords",
      "maxLength": 200
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

search_skills

Search Offline Protocol integration guides (skills) by topic. Returns matching guide names.

Parameters1

query

string

required

Search keywords

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keywords",
      "maxLength": 200
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

list_workflows

List every Offline Protocol product workflow with its capabilities and supported platforms.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_workflow

Get one Offline Protocol workflow in full: capabilities, packages per platform, starter templates and the reference architecture (screens, services, events and data models).

Parameters1

name

string

required

Workflow name, e.g. local-handoff, backend-delivery or nearby-service

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Workflow name, e.g. local-handoff, backend-delivery or nearby-service",
      "maxLength": 128
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

list_skills

List every Offline Protocol integration guide (skill) with the situations it covers.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_skill

Read one Offline Protocol integration guide (skill): API usage, code samples and practices for one area, such as mesh networking, identity or groups.

Parameters1

name

string

required

Skill name, e.g. mesh-networking, identity, groups

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Skill name, e.g. mesh-networking, identity, groups",
      "maxLength": 128
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

resolve_packages

Resolve Offline Protocol packages, or a workflow, for one platform into an exact install list: versions, required and peer dependencies, install commands and license notes.

Parameters3

packages	array	optional	Explicit package names to resolve
workflow	string	optional	Alternatively, a workflow name to resolve
platform	string	required	Target platform

Raw schema

{
  "type": "object",
  "properties": {
    "packages": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 128
      },
      "description": "Explicit package names to resolve",
      "maxItems": 25
    },
    "workflow": {
      "type": "string",
      "description": "Alternatively, a workflow name to resolve",
      "maxLength": 128
    },
    "platform": {
      "type": "string",
      "enum": [
        "react-native",
        "nextjs",
        "react-vite",
        "web",
        "rust"
      ],
      "description": "Target platform"
    }
  },
  "required": [
    "platform"
  ],
  "additionalProperties": false
}

get_template

Get an Offline Protocol starter template's metadata: variables, post-generation steps, notes and file list. Creates no files.

Parameters1

name

string

required

Template name, e.g. react-native-mesh-app

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Template name, e.g. react-native-mesh-app",
      "maxLength": 128
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

generate_architecture

Turn an app idea into an Offline Protocol plan: matching workflow, platform, packages, starter template and architecture documents, returned as text. Returns an error, not a guess, when the idea needs a framework no package supports (such as Flutter or native Swift) unless a platform is given.

Parameters2

prompt	string	required	What you want to build, e.g. 'Hand over equipment between field engineers and reconcile with our backend'
platform	string	optional	Optional platform override; inferred from the prompt otherwise

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "What you want to build, e.g. 'Hand over equipment between field engineers and reconcile with our backend'",
      "maxLength": 2000
    },
    "platform": {
      "type": "string",
      "enum": [
        "react-native",
        "nextjs",
        "react-vite",
        "web",
        "rust"
      ],
      "description": "Optional platform override; inferred from the prompt otherwise"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

preview_scaffold

Preview what an Offline Protocol starter would contain for an app: workflow, template, packages and file list. A dry run that writes nothing; creating the project needs the local Offline Protocol CLI.

Parameters7

prompt	string	optional	Natural-language app idea (uses the planner)
workflow	string	optional	Workflow name, e.g. local-handoff, backend-delivery or nearby-service
template	string	optional	Template name, e.g. react-native-social
platform	string	optional	Required when a multi-platform workflow is named without a template
name	string	required	Project name / directory slug
enableOfflineId	boolean	optional	Enable Offline ID (id-react-native) for React Native templates. Default: true for offline-social-network / offline-id-mesh-chat workflows and react-native-social; auto-switches react-native-mesh-app to react-native-social when true.
enableMesh	boolean	optional	Enable mesh SDK for React Native templates (default: true for mesh workflows / mesh templates)

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Natural-language app idea (uses the planner)",
      "maxLength": 2000
    },
    "workflow": {
      "type": "string",
      "description": "Workflow name, e.g. local-handoff, backend-delivery or nearby-service",
      "maxLength": 128
    },
    "template": {
      "type": "string",
      "description": "Template name, e.g. react-native-social",
      "maxLength": 128
    },
    "platform": {
      "type": "string",
      "enum": [
        "react-native",
        "nextjs",
        "react-vite",
        "web",
        "rust"
      ],
      "description": "Required when a multi-platform workflow is named without a template"
    },
    "name": {
      "type": "string",
      "description": "Project name / directory slug",
      "maxLength": 128
    },
    "enableOfflineId": {
      "type": "boolean",
      "description": "Enable Offline ID (id-react-native) for React Native templates. Default: true for offline-social-network / offline-id-mesh-chat workflows and react-native-social; auto-switches react-native-mesh-app to react-native-social when true."
    },
    "enableMesh": {
      "type": "boolean",
      "description": "Enable mesh SDK for React Native templates (default: true for mesh workflows / mesh templates)"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

README.md5 KBView on GitHub

Offline Protocol agent plugins

Plugins, skills and MCP configuration that connect coding agents (Claude Code, Codex, Cursor, Gemini CLI, VS Code, Cline, Devin and other MCP clients) to the Offline Protocol developer tools. Your agent can find Offline Protocol SDK packages, read integration guides and workflows, plan an implementation, and scaffold or integrate a project on your machine.

Every configuration runs the local MCP server from the published Offline Protocol CLI, npx -y @offline-protocol/cli@0.2.6 mcp serve, or connects to the hosted MCP server at https://mcp.offlineprotocol.com/mcp. The tools help you build an application. They do not discover nearby devices, operate a mesh or control live hardware.

Documentation: https://www.offlineprotocol.com/docs/tools/overview
npm package: https://www.npmjs.com/package/@offline-protocol/cli

This repository is generated from the Offline Protocol CLI source by its export-agent-plugins.mjs script. SOURCE.json records the source commit and a sha256 for every file. Changes are made in the source and exported here; pull requests to this repository are reviewed and applied upstream.

Requirements

Node.js 18 or later with npx. The first run downloads the pinned CLI (@offline-protocol/cli@0.2.6) from npm. Local tools need no Offline Protocol account and send no telemetry. The hosted server needs an application API key and its application ID from https://dev.offlineprotocol.com.

Install

Claude Code plugin

bash

claude plugin marketplace add https://github.com/Offline-Protocol/offline-protocol-agent-plugins.git
claude plugin install offline-protocol@offline-protocol

Codex

bash

codex plugin marketplace add https://github.com/Offline-Protocol/offline-protocol-agent-plugins.git
codex plugin add offline-protocol@offline-protocol

Or add only the MCP server:

bash

codex mcp add offline-protocol -- npx -y @offline-protocol/cli@0.2.6 mcp serve

Cursor

Copy plugins/offline-protocol into ~/.cursor/plugins/local/offline-protocol and reload Cursor. For the MCP server alone, put the contents of distribution/clients/mcp-stdio.json in .cursor/mcp.json or ~/.cursor/mcp.json, or use the install link in distribution/clients/README.md.

Gemini CLI extension

The repository root is a Gemini CLI extension (gemini-extension.json).

bash

gemini extensions install https://github.com/Offline-Protocol/offline-protocol-agent-plugins

VS Code with GitHub Copilot

bash

code --add-mcp '{"name":"offline-protocol","type":"stdio","command":"npx","args":["-y","@offline-protocol/cli@0.2.6","mcp","serve"]}'

For one workspace, copy distribution/clients/vscode.json to .vscode/mcp.json.

Cline

bash

cline mcp install offline-protocol -- npx -y @offline-protocol/cli@0.2.6 mcp serve

Devin

Devin CLI:

bash

devin plugins install Offline-Protocol/offline-protocol-agent-plugins#plugins/offline-protocol

Devin (web): add a custom MCP server with transport stdio, command npx and arguments -y @offline-protocol/cli@0.2.6 mcp serve. Devin Desktop: distribution/clients/devin-desktop.json.

Any other MCP client

Use this server definition (also in distribution/clients/mcp-stdio.json):

json

{
  "mcpServers": {
    "offline-protocol": {
      "command": "npx",
      "args": ["-y", "@offline-protocol/cli@0.2.6", "mcp", "serve"]
    }
  }
}

Zed, Continue, xAI and hosted configurations are in distribution/clients/README.md and distribution/clients/priority-two.md.

What is in here

Path	Contents
`plugins/offline-protocol/`	The plugin: manifests for Claude Code, Codex and Cursor, MCP configuration, the integration skill and the logo
`.claude-plugin/`, `.cursor-plugin/`, `.agents/plugins/`	Marketplace files that point at the plugin
`gemini-extension.json`	Gemini CLI extension manifest
`distribution/clients/`	Ready-to-merge MCP configuration for other clients
`distribution/cline/offline-protocol/`	Cline marketplace entry
`distribution/mcp-registry/`	Official MCP Registry records
`.github/workflows/validate.yml`	Checks that run on every push and pull request: file hashes against `SOURCE.json`, manifest consistency, registry schema validation and a secret scan

Releases are tagged v<version>, where the version is the one in gemini-extension.json and the plugin manifests. The plugin version is separate from the CLI version it launches.

License, privacy and security

The plugin files are licensed under the Apache License 2.0 (LICENSE). The Offline Protocol CLI they launch is also Apache-2.0; SDKs it installs into your projects keep their own licenses, reported by the resolve_packages tool. The Offline Protocol name and logo are trademarks (NOTICE). Using hosted Offline Protocol services is governed by the developer terms at https://www.offlineprotocol.com/legal/developer-terms and the privacy policy at https://www.offlineprotocol.com/privacy. Your agent client and model provider handle tool inputs and results under their own terms.

Report security issues to security@offlineprotocol.com, not in public issues (SECURITY.md).

Install

Tools (15)

list_packagesget_packagesearch_packagessearch_capabilitiessearch_workflowssearch_examplessearch_skillslist_workflows

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.offlineprotocol.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hosted": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.offlineprotocol.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.offlineprotocol/hosted Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_packages

get_package

search_packages

search_capabilities

search_workflows

search_examples

search_skills

list_workflows

get_workflow

list_skills

get_skill

resolve_packages

get_template

generate_architecture

preview_scaffold

Offline Protocol agent plugins

Requirements

Install

Claude Code plugin

Codex

Cursor

Gemini CLI extension

VS Code with GitHub Copilot

Cline

Devin

Any other MCP client

What is in here

License, privacy and security

Install

Remote endpoint

Related servers