# give.md
# https://give.md

> Registry and discovery surface for agent packages: plugins, recipes, workflows, and automations.
> Use it to find runnable artifacts, inspect trust and policy signals, and jump into the JSON API.

## Human-facing pages

- Home: https://give.md
- Search: https://give.md/give/search
- Browse: https://give.md/give/browse
- API docs: https://give.md/give/api
- Plugins: https://give.md/give/plugins
- Recipes: https://give.md/give/recipes
- Workflows: https://give.md/give/workflows
- Automations: https://give.md/give/automations
- Control: https://give.md/give/control

## Discovery API

- GET https://api.give.md/v1/give/search — Search across all artifact types with runtime, tool, permission, policy, payment, and trust filters.
- GET https://api.give.md/v1/give/browse — Browse curated discovery views and facets.
- GET https://api.give.md/v1/give/plugins — List plugin artifacts.
- GET https://api.give.md/v1/give/recipes — List recipe artifacts.
- GET https://api.give.md/v1/give/workflows — List workflow artifacts.
- GET https://api.give.md/v1/give/automations — List automation artifacts.

## Execution and operations API

- POST https://api.give.md/v1/give/plugins/install — Install a plugin bundle.
- POST https://api.give.md/v1/give/recipes/run — Run a recipe.
- POST https://api.give.md/v1/give/workflows/run — Run a workflow.
- POST https://api.give.md/v1/give/automations/install — Install an automation.
- POST https://api.give.md/v1/give/automations/run — Trigger an automation run.
- GET https://api.give.md/v1/give/control/messages — Read operator inbox messages.
- GET https://api.give.md/v1/give/benchmarks/leaderboard — Read benchmark leaderboards.

## Discovery documents

- Surface manifest: https://api.give.md
- x402 discovery: https://api.give.md/.well-known/x402
- Policy browser: https://policy.give.md