@postmcp/presets 0.1.0 → 0.1.3
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 +84 -0
- package/package.json +17 -2
package/README.md
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# @postmcp/presets
|
|
2
|
+
|
|
3
|
+
> **Curated API Presets for PostMCP** - 60+ pre-tuned, context-optimized configurations for developer platforms, cloud providers, and SaaS APIs.
|
|
4
|
+
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
[](https://modelcontextprotocol.io/)
|
|
7
|
+
[](https://www.npmjs.com/package/@postmcp/presets)
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Overview
|
|
12
|
+
|
|
13
|
+
`@postmcp/presets` contains a catalog of over 60 curated API presets configured specifically for Model Context Protocol (MCP) clients.
|
|
14
|
+
|
|
15
|
+
Each preset includes:
|
|
16
|
+
* Direct links to validated OpenAPI specifications.
|
|
17
|
+
* Pre-tuned **Token Diet field masks** to keep context windows small.
|
|
18
|
+
* Pre-configured **composite macros** for common multi-step tasks.
|
|
19
|
+
* Environment variable and credential mappings.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Installation
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npm install @postmcp/presets
|
|
27
|
+
# or
|
|
28
|
+
pnpm add @postmcp/presets
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Programmatic Usage
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
import { ALL_PRESETS, getPresetById, getPresetsByCategory } from '@postmcp/presets';
|
|
37
|
+
|
|
38
|
+
// 1. Get a specific preset by ID
|
|
39
|
+
const stripePreset = getPresetById('stripe');
|
|
40
|
+
console.log(stripePreset.title); // "Stripe Payments API"
|
|
41
|
+
console.log(stripePreset.defaultFieldMask); // Pre-tuned fields
|
|
42
|
+
|
|
43
|
+
// 2. Filter presets by category
|
|
44
|
+
const devPresets = getPresetsByCategory('developer');
|
|
45
|
+
console.log(`Found ${devPresets.length} developer tool presets`);
|
|
46
|
+
|
|
47
|
+
// 3. List all available preset IDs
|
|
48
|
+
const ids = ALL_PRESETS.map((p) => p.id);
|
|
49
|
+
console.log(ids);
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Included Categories & Sample Presets
|
|
55
|
+
|
|
56
|
+
* **Developer Tools**: `@github`, `@gitlab`, `@linear`, `@sentry`, `@datadog`, `@postman`
|
|
57
|
+
* **Finance & Payments**: `@stripe`, `@plaid`, `@square`, `@coinbase`
|
|
58
|
+
* **Cloud & Infrastructure**: `@supabase`, `@cloudflare`, `@digitalocean`, `@render`, `@vercel`
|
|
59
|
+
* **AI & Machine Learning**: `@openai`, `@anthropic`, `@huggingface`, `@replicate`
|
|
60
|
+
* **Communication & Collaboration**: `@slack`, `@twilio`, `@sendgrid`, `@discord`, `@zoom`
|
|
61
|
+
* **E-Commerce & CRM**: `@shopify`, `@hubspot`, `@notion`, `@airtable`
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## CLI Integration
|
|
66
|
+
|
|
67
|
+
Use any preset directly with `@postmcp/cli`:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# Instant zero-config execution
|
|
71
|
+
npx @postmcp/cli run @stripe --token-diet --jit
|
|
72
|
+
|
|
73
|
+
# Export configuration for Cursor
|
|
74
|
+
npx @postmcp/cli export @linear --client cursor --write
|
|
75
|
+
|
|
76
|
+
# Browse available presets
|
|
77
|
+
npx @postmcp/cli presets
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## License
|
|
83
|
+
|
|
84
|
+
MIT (c) [PostMCP Contributors](https://github.com/BraveRam/postmcp/blob/main/LICENSE)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@postmcp/presets",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "50+ Curated, context-optimized API presets for PostMCP",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"dist"
|
|
20
20
|
],
|
|
21
21
|
"dependencies": {
|
|
22
|
-
"@postmcp/types": "0.1.
|
|
22
|
+
"@postmcp/types": "^0.1.3"
|
|
23
23
|
},
|
|
24
24
|
"devDependencies": {
|
|
25
25
|
"@types/node": "^22.13.5",
|
|
@@ -27,6 +27,21 @@
|
|
|
27
27
|
"typescript": "^5.7.3",
|
|
28
28
|
"vitest": "^3.0.7"
|
|
29
29
|
},
|
|
30
|
+
"keywords": [
|
|
31
|
+
"mcp",
|
|
32
|
+
"model-context-protocol",
|
|
33
|
+
"postmcp",
|
|
34
|
+
"openapi",
|
|
35
|
+
"api-presets",
|
|
36
|
+
"stripe",
|
|
37
|
+
"github",
|
|
38
|
+
"linear",
|
|
39
|
+
"slack",
|
|
40
|
+
"supabase",
|
|
41
|
+
"twilio",
|
|
42
|
+
"openai",
|
|
43
|
+
"ai-agents"
|
|
44
|
+
],
|
|
30
45
|
"scripts": {
|
|
31
46
|
"build": "tsup",
|
|
32
47
|
"dev": "tsup --watch",
|