canonical: https://jentic.com/apis/chainstack.com/chainstack

# Chainstack Platform API

The Chainstack API provisions and manages blockchain infrastructure: it creates nodes, groups them into networks, and organizes those networks under projects. It reads and updates organization details, lists project members, and retrieves marketplace application tokens for deployed services. Testnet faucet endpoints dispense Goerli and Sepolia funds for development.

## For AI agents

Create and manage blockchain nodes, networks, and projects, retrieve marketplace application tokens, and request testnet faucet funds through the Chainstack platform API.

## Scope

Does not handle on-chain transactions, smart-contract deployment, or wallet key custody. Use for Chainstack node, network, and project management only.

## Capabilities

- Create and manage blockchain nodes within a project
- Create networks and attach nodes to them
- Organize resources into projects and list project members
- Retrieve application tokens from the marketplace
- Request Goerli and Sepolia testnet funds from the faucet
- Read and update organization details

## Use cases

### AI Agent Node Provisioning

An AI agent connected through Jentic can stand up blockchain infrastructure on request: it creates a project, adds a network, and deploys a node on that network. Chainstack handles the resource hierarchy so the agent provisions the stack instead of clicking through the platform UI.

Example prompt: Create a project, create a network in it, and deploy a node on that network

### Project and Access Organization

Keep infrastructure tidy by grouping networks and nodes under projects and reviewing who has access. Chainstack lists project members and lets you create, update, and delete projects so resources map to teams.

Example prompt: Create a project and list its members to confirm access

### Testnet Faucet Funding

Fund development wallets without leaving the workflow by requesting testnet tokens from the Goerli and Sepolia faucets. Chainstack exposes faucet operations that dispense funds for integration testing.

Example prompt: Request Sepolia testnet funds from the faucet for a development address

### Marketplace Application Tokens

Access deployed marketplace services by retrieving their application tokens. Chainstack returns an application token for a marketplace slug so an integration can call the service it fronts.

Example prompt: Retrieve the application token for a given marketplace application slug

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/nodes/` | List all nodes |
| POST | `/v1/nodes/` | Create a node |
| GET | `/v1/networks/` | List all networks |
| POST | `/v1/networks/` | Create a network |
| GET | `/v1/projects/` | List all projects |
| POST | `/v1/projects/` | Create a project |
| GET | `/v1/organization/` | Get organization name and ID |

## Key resources

- **Organization** — Read and update organization name and identifier
- **Projects** — Project creation, updates, deletion, and member listing
- **Networks** — Network creation, retrieval, update, and deletion
- **Nodes** — Node creation, retrieval, update, and deletion
- **Marketplace** — Marketplace application token retrieval
- **Faucet** — Goerli and Sepolia testnet fund requests

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 53 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 47 / 100
  - Developer Experience & Jentic Compatibility: 51 / 100
  - AI-Readiness & Agent Experience: 39 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 65 / 100
- **View full report:** https://jentic.com/apis/chainstack.com/chainstack/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Chainstack by hand means sending your API key as a bearer token in the Authorization header and tracking the project, network, and node paths yourself. Through Jentic you install once, import Chainstack from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which Chainstack operations the agent may call, such as listing and creating nodes, so deleting nodes, networks, or projects is not included unless you add it.
- **Credential handling:** Your Chainstack API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a blockchain node' or 'list networks', and Jentic returns the matching Chainstack operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Alchemy API** — Alchemy offers managed blockchain node access and web3 developer tooling.
- **QuickNode API** — QuickNode provisions and manages blockchain nodes across many chains.
- **Moralis API** — Moralis provides web3 data APIs for balances, tokens, and transactions.

## FAQ

### What authentication does the Chainstack API use?

The Chainstack API authenticates with an API key provided as a bearer token in the Authorization header, per its OpenAPI spec. You create and manage keys in the Chainstack platform, and through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never appears in the agent's prompt or logs.

### Can I create and manage blockchain nodes with the Chainstack API?

Yes. You can create nodes, retrieve and update them, and delete them, and group them into networks under a project. The API also lists project members and returns marketplace application tokens for deployed services.

### Can I request testnet funds with the Chainstack API?

Yes. The API exposes faucet operations for the Goerli and Sepolia testnets that dispense funds to a development address. This lets an integration top up test wallets without leaving the provisioning workflow.

### Is there a Chainstack MCP server?

You do not need an MCP server to give your agent the Chainstack API. Jentic connects it directly from the API Directory: import Chainstack, store your key once, and your agent provisions nodes and networks through the operations the API already exposes. Operations are discovered on demand, so no extra tool definitions are loaded into the agent's context.

### Can I limit what my agent is allowed to do with the Chainstack API?

Yes. Write a rule that allows only the operations the agent needs, for example listing and creating nodes, and leave out operations like deleting nodes, networks, or projects. The agent provisions infrastructure within those bounds, and every call it makes is logged.

### How do I deploy a node through Jentic with the Chainstack API?

Search Jentic for 'create a blockchain node', which returns the Chainstack operation with its input schema, then supply the project, network, and node configuration and the agent runs it. To run it on your own infrastructure, install Jentic One from its GitHub repo.
