psn-mcp 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +52 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -92,11 +92,58 @@ For PS5 titles pass `npServiceName: "trophy2"`; for PS4 and earlier use
92
92
  `"trophy"`. `psn_get_trophy_titles` reports the right value per game.
93
93
 
94
94
  The three `store` tools browse the public PlayStation Store and need **no PSN
95
- account**. They power prompts like _"give me the top 10 games currently on sale
96
- based on review score"_ — call `psn_get_store_deals` with `includeRatings: true`
97
- and rank by `starRating.averageRating`. Set `PSN_STORE_LOCALE` (e.g. `en-gb`,
98
- `de-de`, `ja-jp`) to change the store region and currency; the default is
99
- `en-us`.
95
+ account**. Set `PSN_STORE_LOCALE` (e.g. `en-gb`, `de-de`, `ja-jp`) to change the
96
+ store region and currency; the default is `en-us`.
97
+
98
+ ## Examples
99
+
100
+ Once the server is connected, just ask in natural language. Some prompts and the
101
+ tools they exercise:
102
+
103
+ **Presence and friends**
104
+
105
+ > _"Is anyone on my friends list online right now? What are they playing?"_
106
+
107
+ Calls `psn_get_friends`, then `psn_get_presence` for each friend, and reports
108
+ who is online, on which platform, and in what game.
109
+
110
+ > _"Look up the profile for online id `Hakoom`."_
111
+
112
+ Calls `psn_get_profile` with `user: "Hakoom"` — any tool that takes a `user`
113
+ accepts `"me"`, an online id, or a numeric account id.
114
+
115
+ **Trophies**
116
+
117
+ > _"What's my trophy level, and what game did I most recently earn trophies
118
+ > in?"_
119
+
120
+ Calls `psn_get_trophy_summary` and `psn_get_trophy_titles` (most recently played
121
+ first).
122
+
123
+ > _"Which trophies am I still missing in Astro Bot, and how rare are they?"_
124
+
125
+ Finds the game via `psn_get_trophy_titles` (getting its `npCommunicationId` and
126
+ `npServiceName`), then combines `psn_get_title_trophies` (names and
127
+ descriptions) with `psn_get_earned_trophies` (earned state and global rarity) to
128
+ list the unearned ones, rarest first.
129
+
130
+ **Play history**
131
+
132
+ > _"How many hours have I put into my ten most-played PS5 games?"_
133
+
134
+ Calls `psn_get_played_games` and ranks by total play duration.
135
+
136
+ **Store (no PSN account needed)**
137
+
138
+ > _"Give me the top 10 games currently on sale based on review score."_
139
+
140
+ Calls `psn_get_store_deals` with `includeRatings: true` and ranks by
141
+ `starRating.averageRating`.
142
+
143
+ > _"Is Elden Ring discounted right now? What do reviewers rate it?"_
144
+
145
+ Calls `psn_search_store` with `query: "Elden Ring"`, then
146
+ `psn_get_store_product` for the price, discount, and star-rating breakdown.
100
147
 
101
148
  ## Architecture
102
149
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "psn-mcp",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "MCP server for interfacing with the PlayStation Network",
5
5
  "type": "module",
6
6
  "license": "MIT",