@obolos_tech/mcp-server 0.2.4 → 0.2.5

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 +18 -2
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -8,16 +8,32 @@ Every API on the Obolos marketplace becomes a tool your AI agent can call — wi
8
8
 
9
9
  ### Claude Code
10
10
 
11
+ By default, `claude mcp add` registers the server for the **current project only**. To make Obolos available in **every Claude Code session** across all your projects, add `--scope user`:
12
+
13
+ **Global (all projects):**
14
+
11
15
  ```bash
12
- claude mcp add obolos -- node /path/to/mcp-server/dist/index.js
16
+ claude mcp add obolos --scope user -e OBOLOS_PRIVATE_KEY=0xyour_private_key -- node /path/to/mcp-server/dist/index.js
13
17
  ```
14
18
 
15
- Or with a payment wallet:
19
+ **Per-project (current project only):**
16
20
 
17
21
  ```bash
18
22
  claude mcp add obolos -e OBOLOS_PRIVATE_KEY=0xyour_private_key -- node /path/to/mcp-server/dist/index.js
19
23
  ```
20
24
 
25
+ **Browse-only (no payments):** omit the `-e OBOLOS_PRIVATE_KEY=...` flag to search and explore APIs without paying.
26
+
27
+ > **Scope reference:**
28
+ >
29
+ > | Scope | Flag | Stored in | Available |
30
+ > |-------|------|-----------|-----------|
31
+ > | Local | *(default)* | `~/.claude.json` (project entry) | Current project only |
32
+ > | Project | `--scope project` | `.mcp.json` at repo root | Anyone who clones the repo |
33
+ > | User | `--scope user` | `~/.claude.json` (global entry) | All projects on your machine |
34
+ >
35
+ > If the same server name exists at multiple scopes, local wins over project, project wins over user.
36
+
21
37
  ### Claude Desktop
22
38
 
23
39
  Add to `~/.claude/claude_desktop_config.json`:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@obolos_tech/mcp-server",
3
- "version": "0.2.4",
3
+ "version": "0.2.5",
4
4
  "description": "MCP server for Obolos x402 API marketplace — lets AI agents discover and pay for APIs",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",