PlayStation Network MCP server

mcp-ps-store

<!-- mcp-name: io.github.murzin-ml/mcp-ps-store -->

MCP server for the PlayStation Network (PSN): it exposes your own gaming history — playtime, trophies, purchased library — so an AI assistant can recommend games from real data instead of guesswork.

Русская версия: README.ru.md.

About

PSN has no public API. This server talks to the same internal API the PlayStation mobile app uses, authenticating with an NPSSO cookie taken from a browser session. Every request is a read; nothing is ever written back to the account.

The layout follows a layered architecture: an API layer (MCP tools), a core layer (services, repositories, DTOs), a DI container and an infrastructure layer.

Core technologies

• Language: Python 3.11+
• Protocol: Model Context Protocol (mcp)
• HTTP client: httpx (async)
• DI container: dependency-injector
• Settings: pydantic-settings
• Dependency management: Poetry
• Testing: Pytest, pytest-asyncio

What it exposes

Plus a recommend_games prompt — a ready-made "build my profile and recommend games" scenario that takes an optional steer such as "something short" or "co-op for two".

Quick start

Python 3.11+ is required.

1. Install

With Poetry:

poetry install

Or with a plain virtualenv:

python3.11 -m venv .venv && .venv/bin/pip install -e .

2. Sign in to PSN

1. Sign in at https://www.playstation.com in a browser.
2. Open https://ca.account.sony.com/api/v1/ssocookie — it returns {"npsso":"..."}.
3. Copy the 64-character npsso value and run:

poetry run psn-login PASTE_NPSSO_HERE

Tokens go to ~/.mcp-ps-store/tokens.json with 0600 permissions.

About session lifetime. The access token lives an hour and the refresh token only ten days, but the NPSSO itself lives about two months. The NPSSO is therefore stored next to the tokens, and the server re-authenticates on its own when the refresh token dies. In practice one psn-login lasts about 60 days.

3. Check it works

poetry run psn-doctor

It prints the account name, how many games are visible and the top five by hours.

Connecting a client

Claude Code

claude mcp add ps-store -- /path/to/mcp-ps-store/.venv/bin/python -m app.main

Claude Desktop

In claudedesktopconfig.json:

{
  "mcpServers": {
    "ps-store": {
      "command": "/path/to/mcp-ps-store/.venv/bin/python",
      "args": ["-m", "app.main"],
      "cwd": "/path/to/mcp-ps-store"
    }
  }
}

Codex CLI

Codex speaks stdio to local MCP servers, so it works the same way. Either run codex mcp add, or add this to ~/.codex/config.toml:

[mcp_servers.ps-store]
command = "/path/to/mcp-ps-store/.venv/bin/python"
args = ["-m", "app.main"]
cwd = "/path/to/mcp-ps-store"

Check it with /mcp inside a Codex session.

ChatGPT

Shortened. The full README is on GitHub.