> ## Documentation Index
> Fetch the complete documentation index at: https://docs.groundforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Choose the Weather MCP or LangChain Agent path and complete a first governed request.

The fastest way to learn GroundForge is to complete one small weather example and then follow the same request in the platform.

## Before you begin

You need:

* access to [platform.groundforge.ai](https://platform.groundforge.ai);
* an Organization and Workspace;
* the `gforge` CLI for command-line steps;
* Python 3.10 or newer;
* the `groundforge-langchain` wheel supplied with your GroundForge release for the Agent example.

## Path A: Weather MCP

<Card title="modelcontextprotocol/quickstart-resources" icon="github" iconType="brands" href="https://github.com/modelcontextprotocol/quickstart-resources/tree/main/weather-server-python" horizontal cta="Open repository">
  Official Python MCP server with `get_alerts(state)` and `get_forecast(latitude, longitude)`.
</Card>

```bash theme={null}
git clone https://github.com/modelcontextprotocol/quickstart-resources.git
cd quickstart-resources/weather-server-python
```

Follow [Weather MCP Example](/examples/weather-mcp) to discover the tools, create Gateway rules, test an allowed call, and review the resulting records.

## Path B: LangChain weather Agent

<Card title="groundforgeai/demo" icon="github" iconType="brands" href="https://github.com/groundforgeai/demo" horizontal cta="Open repository">
  GroundForge external-Agent examples using automatic Channel input handling and explicit adapters.
</Card>

```bash theme={null}
git clone https://github.com/groundforgeai/demo.git
cd demo
```

Choose one:

* [LangChain Agent Example](/examples/langchain-agent) — automatic Channel input handling;
* [LangChain Agent with Adapters](/examples/langchain-adapter) — explicit input and output conversion.

Then attach a Channel, send a weather question, apply a Gateway rule, and open the Trace.

| Twilio                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Mailgun                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Slack                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Webhook                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/twilio.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=23137771bd5787e2f879be0b011b0f6f" alt="Twilio" width="180" height="52" data-path="images/logos/twilio.svg" /> | <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/mailgun.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=e44f0beff51cba2ce8e643efff40199b" alt="Mailgun" width="190" height="52" data-path="images/logos/mailgun.svg" /> | <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/slack.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=bbd3c9f49d4ac80988ae7897c35bca1e" alt="Slack" width="170" height="52" data-path="images/logos/slack.svg" /> | <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/webhook.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=d78ae7cf3160792c859045b3c88be684" alt="Webhook" width="180" height="52" data-path="images/logos/webhook.svg" /> |

## What to check in GroundForge

After the first request, confirm:

1. the Agent or MCP provider is visible in the selected Workspace;
2. Discovery lists the expected weather capability;
3. the Gateway shows the action you selected;
4. an Operator Task appears when the action is Review;
5. the Trace shows the Channel input, decision, capability call, and response.

The next concept page explains how those resources relate: [Resource Model](/concepts/resource-model).


## Related topics

- [Platform Overview](/platform/overview.md)
- [Introduction](/index.md)
- [Start Langchain Agent Job](/api-reference/endpoints/integrations/start-langchain-agent-job.md)
- [External Agents](/platform/external-agents.md)
