---
name: shodai-developer-portal
description: Use when starting from developers.shodai.network to get API access, route into Shodai docs, run SDK experiments, use the API playground, manage keys, or explore the Agreements app.
metadata:
  version: "1.0"
---

# Shodai Developer Portal Skill

Use this skill when the user or agent starts from `https://developers.shodai.network`.

The developer portal is a routing and access surface. It provides API-key access, the API playground, links to docs, links to the Agreements app, and key management. Product/API workflow guidance lives in the canonical Shodai Agreements skill at `https://docs.shodai.network/skill.md`.

## Classify the portal task

Choose the user's primary need:

- Key access or key management
- Docs Quickstart or SDK experiment
- Browser playground experiment
- Existing project integration
- Existing agreement inspection or operation
- Agreements app or product workflow exploration
- API, auth, deployment, signing, or input debugging

If the user already has an API key, project files, an agreement ID, a deployed address, an error response, or a clear task, skip first-visit onboarding and continue from that context.

## Route product/API work to docs

For product/API behavior, load:

- `https://docs.shodai.network/skill.md`
- `https://docs.shodai.network/llms.txt`
- `https://docs.shodai.network/integration-surfaces.md`
- `https://docs.shodai.network/sdks/quickstart-with-typescript-sdk.md`
- `https://docs.shodai.network/sdks/quickstart-with-mcp.md`
- `https://docs.shodai.network/openapi.json`

For MCP-surface routing, follow `https://docs.shodai.network/skill.md`: docs-domain MCP surfaces are for docs/search only, and `https://shodai.network/mcp` is the Agreements execution MCP server.

Use the developer portal runbook at `https://developers.shodai.network/start.md` only for portal-specific routing.

## API access

Use an existing `API_KEY` from the environment or local project context when available.

If the user has delegated setup and browser automation is available, you may use the developer portal to obtain testnet API access. Handle credentials according to the user's environment and normal secret-handling conventions.

## Portal surfaces

- Portal home and key generation: `https://developers.shodai.network/portal`
- API Playground: `https://developers.shodai.network/api-playground/`
- API Playground llms.txt: `https://developers.shodai.network/api-playground/llms.txt`
- API Playground skill: `https://developers.shodai.network/api-playground/skill.md`
- Demo app: `https://app.shodai.network/agreements`
- Docs: `https://docs.shodai.network`
- API Reference: `https://docs.shodai.network/reference/api/system/get-the-openapi-document-for-the-agreements-api`
- API reference and OpenAPI: `https://docs.shodai.network/openapi.json`