Run Vise as an MCP server

Vise ships an MCP adapter, so any MCP-capable host can call Vise’s tools — inspect, plan, check, sensors, docs lookup, and more — directly during the coding loop. Start it with:

vise mcp

This runs a local stdio MCP server. You normally don’t run it by hand; you register the command in your host’s MCP configuration and the host launches it for you.

This is different from the hosted docs MCP server at https://learn.social.plus/mcp (overview). That one is remote (SSE) and only reads documentation. The Vise MCP server runs locally and exposes Vise’s validation and planning tools against the repository you’re working in. You can use both at once.

Prerequisites

Install Vise so the vise command is on your PATH:

npm install -g @amityco/social-plus-vise
vise doctor

If you prefer not to install globally, replace the command below with npx and args ["-y", "-p", "@amityco/social-plus-vise", "vise", "mcp"].

Configure your host

Claude Code
Cursor
VS Code
Codex

Add a project-scoped .mcp.json in your repository root:

{
  "mcpServers": {
    "social-plus-vise": {
      "command": "vise",
      "args": ["mcp"]
    }
  }
}

Add .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "social-plus-vise": {
      "command": "vise",
      "args": ["mcp"]
    }
  }
}

Add .vscode/mcp.json in your project (VS Code uses a servers key):

{
  "servers": {
    "social-plus-vise": {
      "command": "vise",
      "args": ["mcp"]
    }
  }
}

Add the server to ~/.codex/config.toml:

[mcp_servers.social-plus-vise]
command = "vise"
args = ["mcp"]

Restart or reload the host after editing its configuration, then confirm social-plus-vise appears as an available MCP server.

What it exposes

The Vise MCP tools mirror the CLI commands, named in snake_case. The ones you’ll use most:

Tool	Mirrors	Purpose
`inspect_project`	`vise inspect`	Detect platform, surfaces, and sensors
`plan_integration`	`vise plan`	Grounded plan with docs citations and intake
`init_compliance`	`vise init`	Write the `sp-vise/` contract
`check_compliance`	`vise check`	Validate the code against the contract
`run_sensors`	`vise run-sensors`	Run build, lint, typecheck, and smoke checks
`get_sdk_facts`	`vise sdk-facts`	Read grounded SDK surface facts
`search_docs` / `get_doc_page`	`vise search-docs` / `vise get-doc-page`	Find and read social.plus docs
`debug_issue`	`vise debug`	Diagnose an SDK-specific runtime failure
`attest_rule` / `explain_rule`	`vise attest` / `vise explain`	Record evidence and read rule guidance

Skill or MCP?

The skill and the MCP server are complementary:

The skill teaches the agent when to inspect, plan, fetch docs, validate, and attest.
The MCP server exposes the tools the agent calls to do it.

For MCP-capable hosts, install the skill and register the MCP server. On hosts without MCP support, install the skill and let the agent call the vise CLI directly.

Vise overview

Install Vise and run your first integration.

How Vise works

The governed loop and how to read a check result.

CLI reference

The full command set behind these tools.

Docs MCP server

Connect an AI tool to the hosted documentation MCP server.

​Prerequisites

​Configure your host

​What it exposes

​Skill or MCP?

​Related

Vise overview

How Vise works

CLI reference

Docs MCP server

Prerequisites

Configure your host

What it exposes

Skill or MCP?

Related