Sync open source content 🐝 (from 8e46d12bc34acf2647539e8319fbe88929f6d575)

Author: beezythebot

_meta.global.tsx

@@ -99,7 +99,7 @@ const meta = {
                 title: "Using the MCP SDK",
               },
               "build-deploy": {
-                title: "Deploy as MCP",
+                title: "Build and Deploy",
               },
             },
           },

docs/gram/getting-started/typescript.mdx

@@ -5,10 +5,44 @@ description: "Learn how to create and deploy an MCP server using Gram's TypeScri
 
 import { Callout } from "@/mdx/components";
 
-Welcome! This guide will walk you through the process of creating tools and a MCP server using Gram Functions.
-Gram Functions allows you to deploy completely isolated tool call environments that can then be exposed as MCP servers.
+When you need to build tools with custom business logic, data transformations,
+or multi-step workflows, Gram Functions provides a TypeScript framework for
+creating serverless functions that can be exposed as MCP server tools. Unlike
+OpenAPI-sourced tools which simply wrap existing API endpoints, Gram Functions
+allow you to write custom code that executes in isolated environments.
 
-```typescript filename="gram.ts"
+Gram Functions-sourced MCP tools are ideal for the following use cases:
+
+- **Custom business logic**: Implement complex calculations, data processing,
+  or decision-making logic that goes beyond simple API calls. For example,
+  aggregating data from multiple sources or applying custom validation rules.
+- **Data transformations**: Transform, filter, or enrich data before returning
+  it to LLM clients. For example, parsing and summarizing large datasets or
+  converting between data formats.
+- **Multi-step workflows**: Orchestrate multiple API calls or operations in a
+  single tool. For example, creating a tool that searches for data, processes
+  it, and then stores the results.
+
+This guide walks through the steps of building an MCP server with Gram
+Functions. This includes:
+
+- Creating a new Gram Functions project,
+- Writing custom tools with TypeScript,
+- Deploying your functions to Gram, and
+- Creating an MCP server from your tools.
+
+## Before you start
+
+This guide assumes that you have already done the following:
+
+- Created a [Gram account](https://app.getgram.ai),
+- Created a Gram project (accomplished during onboarding), and
+- Installed Node.js version >=22.18.0.
+
+<Callout title="Quick Example" type="info">
+  Here's a simple example of a Gram Function that greets a user:
+
+```typescript
 import { Gram } from "@gram-ai/functions";
 import * as z from "zod/mini";
 
@@ -23,14 +57,15 @@ const gram = new Gram().tool({
 
 export default gram;
 ```
+</Callout>
 
 ## Step 1: Create a project
 
 Gram offers a bootstrapper through `npm/pnpm create` to create a new project.
 
 <Callout title="Note" type="info">
   Gram Functions currently requires a node version >=22.18.0
-</Callout> 
+</Callout>
 
 ```bash
 npm create @gram-ai/function
@@ -79,9 +114,9 @@ export default gram;
 ```
 
 <Callout title="Note" type="info">
-  You are not necessarily building an MCP server here. Write whatever tools you want--you will later be able 
+  You are not necessarily building an MCP server here. Write whatever tools you want--you will later be able
   to slice and dice them into MCP servers or combine them with other types of tools into existing MCP servers.
-</Callout> 
+</Callout>
 
 ## Step 3: Build and deploy
 
@@ -109,4 +144,12 @@ Now, click **Add Tools** to add your tools to the toolset. You'll see the tools
 
 ![Gram Dashboard, showing the add tools dialog](/assets/docs/gram/img/functions/onboarding_add-tools.png)
 
-Finally, head to the **MCP** tab on the toolset page and click **Enable**. Check out the **Install Page** linked therein for help installing the MCP server in your favorite client. For more information on MCP servers, see the [MCP Servers](/docs/gram/host-mcp/deploy-mcp-server) documentation.
+Finally, head to the **MCP** tab on the toolset page and click **Enable**. Check out the **Install Page** linked therein for help installing the MCP server in your favorite client. For more information on MCP servers, see the [MCP Servers](/docs/gram/host-mcp/deploy-mcp-server) documentation.
+
+## What's next?
+
+The following resources will help you get the most out of your Gram MCP server:
+
+- [Learn more about the Gram Functions framework.](/docs/gram/gram-functions/introduction)
+- [Learn about best practices for curating toolsets.](/docs/gram/build-mcp/advanced-tool-curation)
+- [Add OpenAPI-sourced tools to your MCP server.](/docs/gram/getting-started/openapi)