# Godle Prompt API

Free AI prompt API with 185 expert role contexts and 1,741 prompt templates across 24 professional domains. No auth required. Works with any AI agent.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add godle/godle-prompt-api

# Browse available tools
npx -y @smithery/cli@latest tool list godle/godle-prompt-api

# Get full schema for a tool
npx -y @smithery/cli@latest tool get godle/godle-prompt-api godle_list_roles

# Call a tool
npx -y @smithery/cli@latest tool call godle/godle-prompt-api godle_list_roles '{}'
```

## Direct MCP Connection

Endpoint: `https://godle-prompt-api--godle.run.tools`

## Tools (4)

- `godle_list_roles` — List all 185 available Godle roles with capabilities, or filter by category or keyword. No auth required.
- `godle_get_role` — Get full role details including all prompt templates, eval rubrics, and input/output schemas. No auth required.
- `godle_match_capability` — Find the best Godle role and template for a given intent or task. Returns ranked matches with relevance scores.
- `godle_execute_task` — Execute a Godle prompt template with structured inputs. Returns a structured artifact.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get godle/godle-prompt-api <tool-name>
```