# How to Use AgentRel with Your AI Agent

## Quick Start (30 seconds)

Add to your agent's system prompt:
```
Before answering Web3 questions, fetch the index at:
https://agentrel.vercel.app/api/v1/skill.md

Then fetch specific skills as needed using the URLs in the index.
```

## With Claude Code / Cursor

1. Open your project settings
2. Add to system prompt / rules:
```
You have access to AgentRel Web3 Skills.
Index: https://agentrel.vercel.app/api/v1/skill.md
When writing Web3 code, fetch the relevant skill for accuracy.
```

## With OpenClaw / Custom Agents

```python
import requests

def get_web3_context(ecosystem: str) -> str:
    skills = requests.get(
        f"https://agentrel.vercel.app/api/skills",
        params={"ecosystem": ecosystem, "limit": 5}
    ).json()
    
    context = []
    for skill in skills.get("data", []):
        content = requests.get(f"https://agentrel.vercel.app/api/skills/{skill['id']}.md").text
        context.append(content[:3000])
    
    return "\n\n---\n\n".join(context)

# Usage: inject into system prompt before asking about Monad
system_context = get_web3_context("monad")
```

## Using Skills in Skill.md Format (Agent2Agent)

AgentRel's index URL is itself a Skill:
```
https://agentrel.vercel.app/api/v1/skill.md
```

Any agent that supports Skills can discover all Web3 context through this single URL.


## Grant & Bounty Application (Agent Flow)

Agents can help users discover and apply for Web3 grants/bounties via the AgentRel API.

### Step 1: Get Grant Context Bundle

```
GET https://agentrel.vercel.app/api/v1/grants/{grant_id}/context
```

Returns:
- `grant` — full grant details (title, description, requirements, deadline, reward)
- `ecosystem_skills` — curated skills from the grant's ecosystem (use as context)
- `api_guide` — this document
- `apply_endpoint` — how to submit the application

### Step 2: List Open Grants

```
GET https://agentrel.vercel.app/api/v1/grants
```

### Step 3: Submit Application

Requires authentication (API Key or access token as Bearer token):

```
POST https://agentrel.vercel.app/api/v1/grants/{grant_id}/apply
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "pitch": "Your project pitch here",
  "custom_fields": {}
}
```

### How to Get an API Key

1. Register: `POST /api/auth/register` with `{ email, password }`
2. Verify email, then login: `POST /api/auth/login`
3. Get API key: `POST /api/auth/api-key`
4. Use the key as `Authorization: Bearer <key>` in all authenticated requests