@gpsglobal-ai/gpsglobal

GPS LP fund wiki MCP server — connect Cursor, GitHub Copilot, VS Code, and Claude to your GPS fund vault wikis.

Licensed software — not open source. Use is limited to authorized GPS Limited Partners. See LICENSE.

What it does

This package implements a Model Context Protocol (MCP) server so AI assistants can read your GPS fund knowledge wikis securely:

| Tool | Description | |------|-------------| | list_funds | List funds with published wikis only (funds without wiki.md are omitted) | | get_fund_wiki | Return fund wiki markdown. Default format=citeable — one fact per line with PDF page links in content[]. Use format=linked for full wiki, format=raw for byte-identical on-disk wiki.md. |

Data never leaves GPS infrastructure except through your authenticated session — the MCP proxies to https://lp.gpsglobal.ai with LP-scoped JWT or OAuth tokens.

Who this is for

• GPS Limited Partners with access to LP Workspace
• Not for GP operators, content managers, or unauthenticated use

Quick start (recommended)

One command — browser sign-in at production, credentials saved locally, configs merged for major AI hosts:

npx @gpsglobal-ai/gpsglobal setup

This opens https://lp.gpsglobal.ai for OAuth, writes ~/.gps/mcp.env (mode 600), and updates Cursor (OAuth URL), VS Code, GitHub Copilot, and Claude Desktop (stdio) configs.

Restart your AI tool, then ask: "List my GPS funds using gpsglobal".

Local Docker dev (backend on localhost:8080):

GPS_API_BASE=http://localhost:8080 npx @gpsglobal-ai/gpsglobal setup --mode=stdio

Other commands

| Goal | Command | |------|---------| | stdio-only (all hosts) | npx @gpsglobal-ai/gpsglobal setup --mode=stdio | | Verify install + backend reachability | npx @gpsglobal-ai/gpsglobal doctor | | Print config snippets for all hosts | npx @gpsglobal-ai/gpsglobal print-config | | Refresh credentials | npx @gpsglobal-ai/gpsglobal login --browser --refresh |

Global install (optional):

npm install -g @gpsglobal-ai/gpsglobal
gpsglobal setup

Supported AI hosts

| Host | Setup mode | Config key | |------|------------|------------| | Cursor | setup (default oauth) | gpsglobal | | VS Code / GitHub Copilot | setup | gpsglobal | | Windsurf (Cascade) | setup → ~/.codeium/windsurf/mcp_config.json | gpsglobal | | OpenAI ChatGPT | Connectors → OAuth custom connector (see setup output) | gpsglobal | | Grok (xAI) | Remote MCP API server_url (see setup output) | gpsglobal | | Claude Desktop | setup (stdio via envFile) | gpsglobal | | Claude Code | claude mcp add --transport http gpsglobal https://lp.gpsglobal.ai/mcp | gpsglobal | | Cline / Continue / Gemini CLI | mcp-remote bridge (see print-config) | gpsglobal |

OAuth Connect (production): hosts discover auth via https://lp.gpsglobal.ai/mcp — no manual JWT paste.

Cursor example (~/.cursor/mcp.json):

{
  "mcpServers": {
    "gpsglobal": {
      "url": "https://lp.gpsglobal.ai/mcp"
    }
  }
}

Stdio example (Claude Desktop, local dev):

{
  "mcpServers": {
    "gpsglobal": {
      "command": "npx",
      "args": ["-y", "@gpsglobal-ai/gpsglobal", "--stdio"],
      "envFile": "${userHome}/.gps/mcp.env"
    }
  }
}

Security

• Credentials live in ~/.gps/mcp.env — never commit tokens to git
• MCP HTTP uses OAuth 2.1 + PKCE with scoped tokens (aud + mcp:read)
• LP isolation enforced server-side — you only see your own vault
• OAuth tokens expire after 1 hour; run login --refresh or reconnect in your host

Package identity

| | Value | |--|-------| | npm package | @gpsglobal-ai/gpsglobal | | MCP server name (in host config) | gpsglobal | | CLI binary (after global install) | gpsglobal | | Production MCP endpoint | https://lp.gpsglobal.ai/mcp |

Requirements

• Node.js 18+
• Valid GPS LP account on lp.gpsglobal.ai
• Network access to the GPS API (local dev: make dev stack on ports 8080 / 3100)

Troubleshooting

| Issue | Fix | |-------|-----| | Tools return 401 | npx @gpsglobal-ai/gpsglobal login --browser --refresh | | Host shows disconnected | Restart the AI app after setup | | doctor fails | Ensure you are whitelisted on prod; check GPS_API_BASE in ~/.gps/mcp.env (should be https://lp.gpsglobal.ai) | | OAuth Connect loop | Confirm Cursor/VS Code config is URL-only (no stale Bearer header) |

License

Proprietary — not open source.

Copyright © 2026 GPS Global. All rights reserved.

This package is published on npm for convenient installation by authorized GPS Limited Partners only. See LICENSE for full terms.

Unauthorized copying, modification, distribution, or reverse engineering is prohibited.

Links

• LP Workspace: https://lp.gpsglobal.ai
• MCP specification: https://modelcontextprotocol.io