Mateo/dev 42 revamp calling tools in your custom apps quickstart #591
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Collaborator
Author
|
Converted this back to draft because Vercel builds are failing |
…stom-apps-quickstart
vfanelle
reviewed
Dec 10, 2025
Contributor
vfanelle
left a comment
vfanelle
left a comment
There was a problem hiding this comment.
Left a few points of feedback:
- Updated apps to agents in the title
- Asked to put 'from arcadepy import Arcade' in Step 2 code snippet
- I got stuck completing the QuickStart and left a screenshot of the last output I got.
Co-authored-by: vfanelle <vfanelle@gmail.com>
Co-authored-by: vfanelle <vfanelle@gmail.com>
Co-authored-by: vfanelle <vfanelle@gmail.com>
Co-authored-by: vfanelle <vfanelle@gmail.com>
Co-authored-by: vfanelle <vfanelle@gmail.com>
Co-authored-by: vfanelle <vfanelle@gmail.com>
Co-authored-by: vfanelle <vfanelle@gmail.com>
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
Co-authored-by: vfanelle <vfanelle@gmail.com>
vfanelle
approved these changes
Dec 12, 2025
…stom-apps-quickstart
| - Execute your first tool using the Arcade client | ||
| - Authorize a tool to star a GitHub repository on your behalf | ||
| - Build a simple workflow that uses tools to: | ||
| - search for news with Google News |
Contributor
There was a problem hiding this comment.
Suggested change
| - search for news with Google News | |
| - Search for news with Google News |
app/en/home/quickstart/page.mdx
Outdated
|
|
||
| Create a new script called `example.mjs`: | ||
|
|
||
| ```javascript filename="example.mjs" |
Contributor
There was a problem hiding this comment.
.mjs is kinda uncommon these days, more of a legacy thing. I'll try the example with a JS extension and see where I land.
Contributor
There was a problem hiding this comment.
To run it without a package.json, you'll need .mjs. I'm torn because no one uses this in JS tuts. Let me know what you think about using TS, @torresmateo
| </Tabs.Tab> | ||
|
|
||
| </Tabs> | ||
|
|
Contributor
There was a problem hiding this comment.
Recommend quicklinks to API key dashboard and a reminder of where they can find their user ID so they don't end up wandering.
| ```javascript filename="example.mjs" | ||
| import Arcade from "@arcadeai/arcadejs"; | ||
|
|
||
| // You can also set the `ARCADE_API_KEY` environment variable instead of passing it as a parameter. |
Contributor
There was a problem hiding this comment.
I'm a bit concerned we aren't showing them how to add these to an env... api keys in local docs is sort of a nono in tutorials...
Comment on lines
+309
to
327
| ```bash | ||
| uv run example.py | ||
| > latest news about MCP URL mode elicitation: | ||
| > ---------------------------- | ||
| > InfoWorld - Visual Studio Code adds multi-agent orchestration | ||
| > https://www.infoworld.com/article/4105879/visual-studio-code-adds-multi-agent-orchestration.html | ||
| > ---------------------------- | ||
| > Visual Studio Magazine - VS Code 1.107 (November 2025 Update) Expands Multi-Agent Orchestration, Model Management | ||
| > https://visualstudiomagazine.com/articles/2025/12/12/vs-code-1-107-november-2025-update-expands-multi-agent-orchestration-model-management.aspx | ||
| > ---------------------------- | ||
| > SD Times - Several new updates make their way into the MCP specification | ||
| > https://sdtimes.com/ai/several-new-updates-make-their-way-into-the-mcp-specification/ | ||
| > ---------------------------- | ||
| > AI News - How the MCP spec update boosts security as infrastructure scales | ||
| > https://www.artificialintelligence-news.com/news/how-the-mcp-spec-update-boosts-security-as-infrastructure-scales/ | ||
| > | ||
| > {'body': '', 'cc': '', 'date': '', 'from': '', 'header_message_id': '', 'history_id': '', 'id': '19b....', 'in_reply_to': '', 'label_ids': ['UNREAD', 'SENT', 'INBOX'], 'references': '', 'reply_to': '', 'snippet': '', 'subject': '', 'thread_id': '19b....', 'to': '', 'url': 'https://mail.google.com/mail/u/0/#sent/19b....'} | ||
| ``` | ||
Contributor
There was a problem hiding this comment.
Don't include outputs in copy-paste blocks. People copy the whole thing, put it in, and get an error. Do this:
uv run example.pyYou will be asked to authorize the agent by following a link. After you have completed the authorization, you will see a response like:
> latest news about MCP URL mode elicitation:
> ----------------------------
> InfoWorld - Visual Studio Code adds multi-agent orchestration
> https://www.infoworld.com/article/4105879/visual-studio-code-adds-multi-agent-orchestration.html
> ----------------------------
> Visual Studio Magazine - VS Code 1.107 (November 2025 Update) Expands Multi-Agent Orchestration, Model Management
> https://visualstudiomagazine.com/articles/2025/12/12/vs-code-1-107-november-2025-update-expands-multi-agent-orchestration-model-management.aspx
> ----------------------------
> SD Times - Several new updates make their way into the MCP specification
> https://sdtimes.com/ai/several-new-updates-make-their-way-into-the-mcp-specification/
> ----------------------------
> AI News - How the MCP spec update boosts security as infrastructure scales
> https://www.artificialintelligence-news.com/news/how-the-mcp-spec-update-boosts-security-as-infrastructure-scales/
>
> {'body': '', 'cc': '', 'date': '', 'from': '', 'header_message_id': '', 'history_id': '', 'id': '19b....', 'in_reply_to': '', 'label_ids': ['UNREAD', 'SENT', 'INBOX'], 'references': '', 'reply_to': '', 'snippet': '', 'subject': '', 'thread_id': '19b....', 'to': '', 'url': 'https://mail.google.com/mail/u/0/#sent/19b....'}
```
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Preview here
This PR reworks the main quickstart to move from 3 disconnected tool calls to a more useful workflow that features
The workflow itself:
Since there is a helper function now, the structure of the code went from a single piece of code, to 3 sections of code to make it easier and faster to digest.
Note
Reworks the quickstart into a workflow-based guide (news → Google Doc → email) with Python/JS examples and an auth helper, plus minor title/meta and styling tweaks.
app/en/home/_meta.tsxandapp/en/home/quickstart/page.mdx.guide-overviewclass inapp/_components/guide-overview.tsx.app/globals.css(.guide-overview ul ul { margin-top: 0; }).Written by Cursor Bugbot for commit e547534. This will update automatically on new commits. Configure here.