> ## 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.

# Discovery

> Let GroundForge learn which capabilities an Agent or MCP provider exposes.

Discovery reads capability definitions and stores their names, descriptions, types, and input schemas. It does not run the capabilities.

## Example

The Weather MCP exposes:

```text theme={null}
get_alerts(state: string)
get_forecast(latitude: number, longitude: number)
```

After Discovery, GroundForge can show these capabilities in the platform and use them when you create Gateway rules.

Run Discovery when:

* you connect an Agent or MCP provider for the first time;
* you intentionally add or remove a capability;
* you change a capability input schema.

## CLI examples

```bash theme={null}
gforge agents discovery <agent-id>
gforge agents discovery <agent-id> --status

gforge providers discover <provider-id>
gforge providers inventory <provider-id>
```

`--status` shows the progress of an Agent discovery request. Opening Observations or Drifts does not start Discovery.

Continue with [Observations](/concepts/observations), [Drifts](/concepts/drifts), or [Weather MCP Example](/examples/weather-mcp).


## Related topics

- [Discovery and Traces](/cli/observability.md)
- [Get Agent Discovery](/api-reference/endpoints/agents/get-agent-discovery.md)
- [Request Agent Discovery](/api-reference/endpoints/agents/request-agent-discovery.md)
- [Cancel Agent Discovery](/api-reference/endpoints/agents/cancel-agent-discovery.md)