Skip to content

Commit c906547

Browse files
author
Ratnakar Asara
committed
replace graphql api testing with mcp tool testing
Signed-off-by: Ratnakar Asara <rasara@us.ibm.com>
1 parent 16020bf commit c906547

File tree

1 file changed

+8
-19
lines changed

1 file changed

+8
-19
lines changed

executable/tools-with-descriptions/README.md

Lines changed: 8 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -95,27 +95,16 @@ An AI model can use this tool by:
9595
2. **Structured Input Validation**: The GraphQL schema ensures that inputs are properly validated.
9696
3. **Documentation**: The descriptions serve as both documentation for developers and instructions for AI models.
9797

98-
## Testing
98+
### Testing as an MCP Tool
9999

100-
You can test this tool by:
100+
To test this as an MCP tool with AI models:
101101

102-
1. Deploying the schema to StepZen using the command `stepzen deploy`
103-
2. Making requests to the MCP endpoint with tool calls
104-
3. Verifying that the tool returns properly structured weather data.
102+
1. Deploy the schema to StepZen using the command `stepzen deploy`
103+
2. [Connect Claude Desktop](https://modelcontextprotocol.io/docs/develop/connect-local-servers) to your StepZen MCP endpoint
104+
3. The tool will appear as `weather-lookup` and can be called by the AI model
105105

106+
**Example**: Interaction between MCP and the Claude UI.
106107

108+
<img width="563" height="360" alt="Image" src="https://github.com/user-attachments/assets/7da0cd20-2469-45cd-8a17-0891a1a03dec" />
107109

108-
Sydney, defaults to 3 days
109-
110-
curl \
111-
--header "Authorization: Apikey $(stepzen whoami --apikey)" \
112-
--header "Content-Type: application/json" \
113-
'https://changjaeto.us-east-a.ibm.stepzen.net/api/miscellaneous/graphql?documentId=sha256:1bc7a3eefaa1f9dc0a3bbe2eba6cdcbf393aac3b1273a036b885ac1407eac11a&operationName=WeatherForecast&variables=%7B%22city%22%3A%20%22Sydney%22%7D'
114-
115-
116-
Sydney, 1 day
117-
118-
curl \
119-
--header "Authorization: Apikey $(stepzen whoami --apikey)" \
120-
--header "Content-Type: application/json" \
121-
'https://changjaeto.us-east-a.ibm.stepzen.net/api/miscellaneous/graphql?documentId=sha256:1bc7a3eefaa1f9dc0a3bbe2eba6cdcbf393aac3b1273a036b885ac1407eac11a&operationName=WeatherForecast&variables=%7B%22city%22%3A%20%22Sydney%22%2C%20%22days%22%3A%201%7D'
110+
<img width="502" height="588" alt="Image" src="https://github.com/user-attachments/assets/cf499b7e-a3fe-433c-b837-bdde25441739" />

0 commit comments

Comments
 (0)