Blockversity LinkedIn MCP Server

A Model Context Protocol (MCP) server for the Blockversity LinkedIn Community integration.

Installation

npx -y @knowledgebuilders/blockversity-linkedin-mcp

Setup

This package is configured with a WordPress access token.

1. Open the MCP Connection page in WordPress admin.
2. Generate an MCP token.
3. Copy the generated config snippet for Codex, Claude Code, or OpenCode.

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.blockversity-linkedin]
command = "npx"
args = ["-y", "@knowledgebuilders/blockversity-linkedin-mcp"]

[mcp_servers.blockversity-linkedin.env]
WP_BASE_URL = "https://community.knowledgebuilders.app"
WP_BV_ACCESS_TOKEN = "YOUR_GENERATED_TOKEN"

Or add it with the CLI:

codex mcp add blockversity-linkedin --env WP_BASE_URL=https://community.knowledgebuilders.app --env WP_BV_ACCESS_TOKEN=YOUR_GENERATED_TOKEN -- npx -y @knowledgebuilders/blockversity-linkedin-mcp

Claude Code

Add this to .mcp.json:

{
  "mcpServers": {
    "blockversity-linkedin": {
      "command": "npx",
      "args": ["-y", "@knowledgebuilders/blockversity-linkedin-mcp"],
      "env": {
        "WP_BASE_URL": "https://community.knowledgebuilders.app",
        "WP_BV_ACCESS_TOKEN": "YOUR_GENERATED_TOKEN"
      }
    }
  }
}

OpenCode

Add this to opencode.json in your project root:

{
  "mcp": {
    "blockversity-linkedin": {
      "type": "local",
      "command": ["npx", "-y", "@knowledgebuilders/blockversity-linkedin-mcp"],
      "environment": {
        "WP_BASE_URL": "https://community.knowledgebuilders.app",
        "WP_BV_ACCESS_TOKEN": "YOUR_GENERATED_TOKEN"
      },
      "enabled": true
    }
  }
}

CLI Commands

whoami

Verify the configured token:

WP_BASE_URL=https://community.knowledgebuilders.app \
WP_BV_ACCESS_TOKEN=YOUR_GENERATED_TOKEN \
npx -y @knowledgebuilders/blockversity-linkedin-mcp whoami

serve

Start the MCP server directly:

WP_BASE_URL=https://community.knowledgebuilders.app \
WP_BV_ACCESS_TOKEN=YOUR_GENERATED_TOKEN \
npx -y @knowledgebuilders/blockversity-linkedin-mcp serve

WordPress Configuration

The WordPress plugin provides:

• MCP token generation and revocation
• ready-made Codex, Claude Code, and OpenCode config snippets
• a public package config endpoint at /wp-json/bv-auth/v1/mcp/config

The public config endpoint now advertises token-based setup only.

Troubleshooting

Codex is not reading my config

Codex uses ~/.codex/config.toml, not ~/.codex/config.json.

Token stopped working

Generate a new token from the WordPress MCP Connection page and replace WP_BV_ACCESS_TOKEN in your config.

Revoke access

Use the Active MCP Tokens table in WordPress admin to revoke any token immediately.

License

MIT