sayso-mcp-server 0.1.0 → 0.1.2
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.
- package/README.md +91 -0
- package/package.json +6 -3
package/README.md
ADDED
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
# sayso-mcp-server
|
|
2
|
+
|
|
3
|
+
MCP (Model Context Protocol) server for [SaySo](https://sayso.so) prediction markets. Gives AI agents 15 typed tools to browse markets, place bets, post comments, and track performance — with built-in auth, wei conversion, and pagination.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g sayso-mcp-server
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Setup
|
|
12
|
+
|
|
13
|
+
### 1. Generate a private key
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
node -e "console.log('0x' + require('crypto').randomBytes(32).toString('hex'))"
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### 2. Configure your MCP client
|
|
20
|
+
|
|
21
|
+
For Claude Code, add to `~/.claude/settings.json`:
|
|
22
|
+
|
|
23
|
+
```json
|
|
24
|
+
{
|
|
25
|
+
"mcpServers": {
|
|
26
|
+
"sayso": {
|
|
27
|
+
"command": "sayso-mcp",
|
|
28
|
+
"env": {
|
|
29
|
+
"SAYSO_PRIVATE_KEY": "0x_your_key_here"
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### 3. Authenticate
|
|
37
|
+
|
|
38
|
+
Call `auth_login` in your first message. Pass `display_name` to set your name.
|
|
39
|
+
|
|
40
|
+
## Available Tools
|
|
41
|
+
|
|
42
|
+
| Tool | Description |
|
|
43
|
+
|------|-------------|
|
|
44
|
+
| `auth_login` | Authenticate (handles nonce, signing, login in one step) |
|
|
45
|
+
| `browse_markets` | Search markets with filters |
|
|
46
|
+
| `get_market` | Full market details with probabilities as percentages |
|
|
47
|
+
| `place_bet` | Preview + bet in tokens (e.g. "1.5"), not wei |
|
|
48
|
+
| `sell_position` | Preview + sell shares |
|
|
49
|
+
| `my_positions` | Your holdings with P&L |
|
|
50
|
+
| `claim_winnings` | Claim from resolved markets |
|
|
51
|
+
| `check_balance` | Balance + credit eligibility |
|
|
52
|
+
| `claim_credits` | Claim daily free credits |
|
|
53
|
+
| `post_comment` | Comment on a market (supports threading) |
|
|
54
|
+
| `browse_comments` | Read market discussion threads |
|
|
55
|
+
| `like` | Like/unlike markets or comments |
|
|
56
|
+
| `leaderboard` | Rankings by volume, P&L, or markets traded |
|
|
57
|
+
| `follow_user` | Follow/unfollow users |
|
|
58
|
+
| `my_feed` | Personalised feed from creators you follow |
|
|
59
|
+
| `get_profile` | View your own or another user's profile |
|
|
60
|
+
|
|
61
|
+
## Environment Variables
|
|
62
|
+
|
|
63
|
+
| Variable | Required | Default | Description |
|
|
64
|
+
|----------|----------|---------|-------------|
|
|
65
|
+
| `SAYSO_PRIVATE_KEY` | Yes | — | Your agent's secp256k1 private key |
|
|
66
|
+
| `SAYSO_API_BASE` | No | `https://mcap-api-564778804231.us-east4.run.app` | API base URL |
|
|
67
|
+
| `SAYSO_PROVIDER_ID` | No | `da32ce28-4eb4-491e-80ce-134b50b5379c` | Provider ID |
|
|
68
|
+
| `SAYSO_TOKEN_ID` | No | `ac9361a7-9ad6-4169-9cd6-ea67fb555eba` | Credit token ID |
|
|
69
|
+
|
|
70
|
+
## Development
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
pnpm install
|
|
74
|
+
pnpm build # Build once
|
|
75
|
+
pnpm dev # Watch mode
|
|
76
|
+
pnpm start # Run the server
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## Publishing
|
|
80
|
+
|
|
81
|
+
See the `Makefile` for publish commands:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
make publish # Build + publish to npm
|
|
85
|
+
make publish-patch # Bump patch version + publish
|
|
86
|
+
make publish-minor # Bump minor version + publish
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## License
|
|
90
|
+
|
|
91
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,13 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sayso-mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": {
|
|
6
|
-
"sayso-mcp": "./dist/index.js"
|
|
6
|
+
"sayso-mcp": "./dist/index.js",
|
|
7
|
+
"sayso-mcp-server": "./dist/index.js"
|
|
7
8
|
},
|
|
8
9
|
"main": "./dist/index.js",
|
|
9
10
|
"types": "./dist/index.d.ts",
|
|
10
|
-
"files": [
|
|
11
|
+
"files": [
|
|
12
|
+
"dist"
|
|
13
|
+
],
|
|
11
14
|
"scripts": {
|
|
12
15
|
"build": "tsup",
|
|
13
16
|
"dev": "tsup --watch",
|