You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/gram/api-clients/using-vellum-workflows-sdk-with-gram-mcp-servers.mdx
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ If you already have a Gram MCP server configured, you can skip to [connecting Ve
29
29
30
30
In the [Gram dashboard](https://app.getgram.ai), click **New Project** to create a new project. Enter a project name and click **Submit**
31
31
32
-
32
+
33
33
34
34
Once you've created the project, click the **Get Started** button.
35
35
@@ -39,39 +39,39 @@ Choose **Start from API**. Gram then guides you through the following steps.
39
39
40
40
Upload the [Push Advisor OpenAPI document](https://github.com/ritza-co/gram-examples/blob/main/push-advisor-api/openapi.yaml), enter the name of your API, and click **Continue**.
41
41
42
-
42
+
43
43
44
44
#### Step 2: Create a toolset
45
45
46
46
Give your toolset a name (for example, `Push Advisor`) and click **Continue**.
47
47
48
-
48
+
49
49
50
50
Notice that the **Name Your Toolset** dialog displays the names of the tools that Gram will generate from your OpenAPI document.
51
51
52
52
#### Step 3: Configure MCP
53
53
54
54
Enter a URL slug for the MCP server and click **Continue**.
55
55
56
-
56
+
57
57
58
58
Gram will create a new toolset from the OpenAPI document.
59
59
60
60
Click **Toolsets** in the sidebar to view the Push Advisor toolset.
61
61
62
-
62
+
63
63
64
64
### Configuring environment variables
65
65
66
66
[Environments](/docs/gram/concepts/environments) store API keys and configuration separately from your toolset logic.
67
67
68
68
In the **Environments** tab, click the **Default** environment. Click **Fill for Toolset**. Select the **Push Advisor** toolset and click **Fill Variables** to automatically populate the required variables.
69
69
70
-
70
+
71
71
72
72
The Push Advisor API is hosted at `https://canpushtoprod.abdulbaaridavids04.workers.dev`, so set the `<your_API_name>_SERVER_URL` environment variable to `https://canpushtoprod.abdulbaaridavids04.workers.dev`. Click **Save**.
73
73
74
-
74
+
75
75
76
76
### Publishing an MCP server
77
77
@@ -81,7 +81,7 @@ Go to the **MCP** tab, find the Push Advisor toolset, and click the title of the
81
81
82
82
On the **MCP Details** page, click **Enable** and then **Enable Server** to enable the server.
83
83
84
-
84
+
85
85
86
86
Take note of your MCP server URL in the **Hosted URL** section.
87
87
@@ -142,7 +142,7 @@ A Vellum Workflow has three main components:
142
142
143
143
For this Workflow, the Agent node can make multiple calls to the MCP server (as many as needed to answer the query).
144
144
145
-
145
+
146
146
147
147
Inside the project directory, create a file called `workflow.py`. Start by defining the input structure:
148
148
@@ -322,7 +322,7 @@ uv run python workflow.py "Is it safe to push to production today?"
322
322
323
323
The output shows the agent's response after it queries the MCP server and evaluates whether pushing to production is safe.
324
324
325
-
325
+
Copy file name to clipboardExpand all lines: docs/gram/clients/using-vellum-agents-with-gram-mcp-servers.mdx
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ If you already have a Gram MCP server configured, you can skip to [connecting Ve
26
26
27
27
In the [Gram dashboard](https://app.getgram.ai), click **New Project** to create a new project. Enter a project name and click **Submit**
28
28
29
-
29
+
30
30
31
31
Once you've created the project, click the **Get Started** button.
32
32
@@ -36,39 +36,39 @@ Choose **Start from API**. Gram then guides you through the following steps.
36
36
37
37
Upload the [Push Advisor OpenAPI document](https://github.com/ritza-co/gram-examples/blob/main/push-advisor-api/openapi.yaml), enter the name of your API, and click **Continue**.
38
38
39
-
39
+
40
40
41
41
#### Step 2: Create a toolset
42
42
43
43
Give your toolset a name (for example, `Push Advisor`) and click **Continue**.
44
44
45
-
45
+
46
46
47
47
Notice that the **Name Your Toolset** dialog displays the names of the tools that Gram will generate from your OpenAPI document.
48
48
49
49
#### Step 3: Configure MCP
50
50
51
51
Enter a URL slug for the MCP server and click **Continue**.
52
52
53
-
53
+
54
54
55
55
Gram will create a new toolset from the OpenAPI document.
56
56
57
57
Click **Toolsets** in the sidebar to view the Push Advisor toolset.
58
58
59
-
59
+
60
60
61
61
### Configuring environment variables
62
62
63
63
[Environments](/docs/gram/concepts/environments) store API keys and configuration separately from your toolset logic.
64
64
65
65
In the **Environments** tab, click the **Default** environment. Then click **Fill for Toolset**, select the **Push Advisor** toolset, and click **Fill Variables** to automatically populate the required variables.
66
66
67
-
67
+
68
68
69
69
The Push Advisor API is hosted at `https://canpushtoprod.abdulbaaridavids04.workers.dev`, so set the `<your_API_name>_SERVER_URL` environment variable to `https://canpushtoprod.abdulbaaridavids04.workers.dev`. Click **Save**.
70
70
71
-
71
+
72
72
73
73
### Publishing an MCP server
74
74
@@ -78,7 +78,7 @@ Go to the **MCP** tab, find the Push Advisor toolset, and click the title of the
78
78
79
79
On the **MCP Details** page, click **Enable** and then **Enable Server** to enable the server.
80
80
81
-
81
+
82
82
83
83
Take note of your MCP server URL in the **Hosted URL** section.
84
84
@@ -92,11 +92,11 @@ With the Push Advisor MCP server ready, you can connect it to Vellum by configur
92
92
93
93
Configuring the MCP server requires your Gram Key. To add it as a secret, navigate to **Profile → Settings → Secrets & Variables → + Add Environment Variable**.
94
94
95
-
95
+
96
96
97
97
Enter `GRAM_KEY` for the variable name, paste your Gram key as the value, and click **Create Variable**.
98
98
99
-
99
+
100
100
101
101
## Adding a Vellum agent
102
102
@@ -110,15 +110,15 @@ Otherwise, use the **Create Workflow** button to create a new Workflow:
110
110
111
111
- Add an **Agent** node.
112
112
113
-
113
+
114
114
115
115
- Click the **Agent** node, then click **+ Tool**.
116
116
117
-
117
+
118
118
119
119
- Select **MCP Server** from the **Tool Type** options.
120
120
121
-
121
+
122
122
123
123
- Configure the MCP server as follows:
124
124
@@ -128,31 +128,31 @@ Otherwise, use the **Create Workflow** button to create a new Workflow:
128
128
-**API Key Header Name:** Authorization
129
129
-**API Key Value:** GRAM_KEY
130
130
131
-
131
+
132
132
133
133
- Click **Confirm** to save.
134
134
135
135
Vellum automatically discovers the available tools. You should see the MCP server listed under **Tools**.
136
136
137
137
- Now, go to the **Overview** tab and click **Edit Prompt** to add a prompt.
138
138
139
-
139
+
140
140
141
141
- In the modal, enter this system prompt:
142
142
143
143
```
144
144
Is it safe to push to production today?
145
145
```
146
146
147
-
147
+
148
148
149
149
- Connect the **Entrypoint** node to the **Agent** node, then connect the **Agent** node to the **Output**. Click on the **Output** node and under **Overview → Output Value**, select **Agent** for the **Node Output**, and select **Text** for the **Output Name**.
150
150
151
-
151
+
152
152
153
153
- Click **▶️ Run**. The Workflow should return a response indicating whether pushing to production is safe based on the Push Advisor server's evaluation.
154
154
155
-
155
+
0 commit comments