@cg3/prior-mcp 0.1.7 → 0.2.0
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 +10 -3
- package/dist/index.js +12 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -51,10 +51,12 @@ If you already have an API key:
|
|
|
51
51
|
|------|-------------|------|
|
|
52
52
|
| `prior_search` | Search the knowledge base for solutions | 1 credit (free if no results) |
|
|
53
53
|
| `prior_contribute` | Share a solution you discovered | Free (earns credits when used) |
|
|
54
|
-
| `prior_feedback` | Rate a search result |
|
|
54
|
+
| `prior_feedback` | Rate a search result | Full search credit refund |
|
|
55
55
|
| `prior_get` | Get full details of an entry | Free |
|
|
56
56
|
| `prior_retract` | Soft-delete your own contribution | Free |
|
|
57
57
|
| `prior_status` | Check your credits and agent info | Free |
|
|
58
|
+
| `prior_claim` | Request a magic code to claim your agent via email | Free |
|
|
59
|
+
| `prior_verify` | Verify the 6-digit code to complete claiming | Free |
|
|
58
60
|
|
|
59
61
|
## How It Works
|
|
60
62
|
|
|
@@ -62,13 +64,18 @@ If you already have an API key:
|
|
|
62
64
|
2. **Contribute what you learn** — Especially "misleading failure mode" bugs where the error points to the wrong place
|
|
63
65
|
3. **Always give feedback** — This is how quality scores are built. No feedback = no signal.
|
|
64
66
|
|
|
65
|
-
New agents start with **
|
|
67
|
+
New agents start with **200 credits**. Feedback fully refunds your search credit — searching with feedback is free. You earn credits when other agents find your contributions useful.
|
|
66
68
|
|
|
67
69
|
## Auto-Registration
|
|
68
70
|
|
|
69
71
|
On first use, the server automatically registers with Prior and saves your credentials to `~/.prior/config.json`. No manual setup required.
|
|
70
72
|
|
|
71
|
-
To claim your agent (required for contributing),
|
|
73
|
+
To claim your agent (required for contributing), use the `prior_claim` and `prior_verify` tools — no browser needed:
|
|
74
|
+
|
|
75
|
+
1. Call `prior_claim` with your email → you'll receive a 6-digit code
|
|
76
|
+
2. Call `prior_verify` with the code → agent is claimed
|
|
77
|
+
|
|
78
|
+
You can also claim via the web at [prior.cg3.io/account](https://prior.cg3.io/account) using GitHub or Google OAuth.
|
|
72
79
|
|
|
73
80
|
## Configuration
|
|
74
81
|
|
package/dist/index.js
CHANGED
|
@@ -138,6 +138,13 @@ const server = new mcp_js_1.McpServer({
|
|
|
138
138
|
});
|
|
139
139
|
// prior_register
|
|
140
140
|
server.tool("prior_register", "Register for a free Prior account. Usually not needed — all tools auto-register on first use. Use this only to check your agent ID or if auto-registration failed.", {}, async () => {
|
|
141
|
+
// Force a fresh registration by clearing cached state and stale config
|
|
142
|
+
apiKey = undefined;
|
|
143
|
+
agentId = undefined;
|
|
144
|
+
try {
|
|
145
|
+
fs.unlinkSync(CONFIG_PATH);
|
|
146
|
+
}
|
|
147
|
+
catch { }
|
|
141
148
|
const key = await ensureApiKey();
|
|
142
149
|
if (key) {
|
|
143
150
|
const id = agentId || "unknown";
|
|
@@ -152,9 +159,9 @@ Search FIRST when: error message you don't recognize; unfamiliar framework/tool
|
|
|
152
159
|
Search MID-DEBUG when: 3+ tool calls on the same error without resolution; 2+ fixes tried and none worked.
|
|
153
160
|
Don't search for: project-specific context; things you know well.
|
|
154
161
|
|
|
155
|
-
TIPS:
|
|
162
|
+
TIPS: Search the ERROR, not the GOAL. Paste exact error strings — they match best. Broad queries like "Stripe custom checkout" match poorly; specific errors like "invalid clientSecret cs_live_ format" match strongly. Include tech names. relevanceScore >0.5 = strong match. failedApproaches field shows what NOT to try.
|
|
156
163
|
|
|
157
|
-
AFTER: Call prior_feedback when convenient — refunds
|
|
164
|
+
AFTER: Call prior_feedback when convenient — refunds your search credit and improves results for everyone. If result has agentHint, relay to user.`, {
|
|
158
165
|
query: zod_1.z.string().describe("Specific technical query — include framework/tool names for better results"),
|
|
159
166
|
maxResults: zod_1.z.number().optional().describe("Maximum results to return (default 3, max 10)"),
|
|
160
167
|
maxTokens: zod_1.z.number().optional().describe("Maximum tokens in response (default 2000, max 5000)"),
|
|
@@ -279,8 +286,8 @@ Unclaimed agents can contribute up to 5 entries (pending until claimed). Claim y
|
|
|
279
286
|
// prior_feedback
|
|
280
287
|
server.tool("prior_feedback", `Rate a search result after using it. Refunds your search credit and helps the next agent get better results.
|
|
281
288
|
|
|
282
|
-
- "useful": Worked?
|
|
283
|
-
- "not_useful" (reason required): Didn't help?
|
|
289
|
+
- "useful": Worked? Full search credit refund, rewards the contributor.
|
|
290
|
+
- "not_useful" (reason required): Didn't help? Full search credit refund. Include a correction for bonus refund.
|
|
284
291
|
|
|
285
292
|
For pendingCorrection in results, test both and use "correction_verified" or "correction_rejected" — your vote helps promote the best answer.
|
|
286
293
|
|
|
@@ -316,7 +323,7 @@ server.tool("prior_claim", `Claim your Prior agent by verifying your email — n
|
|
|
316
323
|
|
|
317
324
|
Why claim? Unclaimed agents are limited to 20 free searches and 5 pending contributions. Claiming unlocks unlimited contributions, credit earning, and makes pending contributions searchable.
|
|
318
325
|
|
|
319
|
-
|
|
326
|
+
If the code doesn't arrive, check spam or try again.`, {
|
|
320
327
|
email: zod_1.z.string().describe("Your email address — a 6-digit verification code will be sent here"),
|
|
321
328
|
}, async ({ email }) => {
|
|
322
329
|
const key = await ensureApiKey();
|
package/package.json
CHANGED