# motto MCP Server
# Endpoint: /api/mcp
# Protocol: MCP (Model Context Protocol) over Streamable HTTP
# Authentication: OAuth 2.0 Authorization Code + PKCE (Auth0)

## Available Tools

### search_gives
Search for gives using natural language or structured queries.
Supports semantic search, filtering by category/type/genre/area, and pagination.

### get_give
Get detailed information about a specific give by ID.

### create_give
Create a new give on behalf of the authenticated user.
Supports item and skill categories (event not yet supported).

### request_match
Send a match request to a give owner.

### get_matches
List all match requests the user is involved in (as applicant or give owner).

### negotiate_match
Perform negotiation actions (agree, reject, message) on a match request.

## Discovery
- OAuth Metadata: /.well-known/oauth-authorization-server
- MCP Config: /.well-known/mcp.json

## Rate Limits
- Authenticated: 60 req/min
- Unauthenticated: 10 req/min