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

# Guru

> Search and read Guru knowledge-base cards and collections, and create or verify cards

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: Basic auth.
* **Connection**: HTTP Basic auth with `GURU_USERNAME` as the username and `GURU_USER_TOKEN` as the password.
* **Docs**: [https://developer.getguru.com/docs/getting-started](https://developer.getguru.com/docs/getting-started)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable          | Required | Description                                                                                                                                                            |
| ----------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GURU_USERNAME`   | Yes      | HTTP Basic username: your Guru user email (for a User token) or the collection ID (for a Collection token) [Docs](https://developer.getguru.com/docs/getting-started). |
| `GURU_USER_TOKEN` | Yes      | HTTP Basic password: the Guru User or Collection API token generated in API Access settings [Docs](https://developer.getguru.com/docs/getting-started).                |

## Setup

1. **Get a Guru account**: Sign up at [https://www.getguru.com](https://www.getguru.com) - a free trial workspace is enough for testing the API.
2. **Generate an API token**: In Guru, open Settings → API Access and generate a token. A User token (username = your email) acts as you across the knowledge base; a Collection token (username = collection ID) gives read-only access to one collection. Admins can issue tokens for other users.
3. **Store the credentials**: Add GURU\_USERNAME=\<your email or collection ID> and GURU\_USER\_TOKEN=\<your token> to your .env file. The API uses HTTP Basic auth against [https://api.getguru.com/api/v1](https://api.getguru.com/api/v1).
4. **Verify access**: Run the List Collections tool (or GET /api/v1/teams with curl) - a successful response confirms your credentials work.

* Collection tokens are read-only and scoped to a single collection - use a User token for the Create Card and Verify Card tools
* Card search returns at most 50 results per page; narrow your search terms instead of paging when possible
* shareStatus must be TEAM for a card to be visible to the whole team

Provider API reference: [https://developer.getguru.com/reference](https://developer.getguru.com/reference)

## Tools

| Tool             | Access | Description                                                                                           |
| ---------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| Search Cards     | Read   | Search the knowledge base for cards matching search terms                                             |
| Get Card         | Read   | Get a single card with its full content and additional details (collection, verifiers, collaborators) |
| List Collections | Read   | List the collections in the team to find collection IDs, names, and stats                             |
| Create Card      | Write  | Create a new knowledge-base card in a collection                                                      |
| Update Card      | Write  | Update an existing card's title, content, or visibility to keep knowledge current                     |
| Verify Card      | Write  | Mark a card as verified, confirming its content is accurate and up to date                            |

## Example prompts

* Search my Guru knowledge base for cards about a topic I specify and summarize the verified answer.
* Turn the information I give you into a well-structured Guru card and create it in the collection I specify.
* Look up a Guru card I specify, check whether its content still looks accurate, and verify it if so.