Pentagonal MCP server
✓ VerifiedEnables AI clients to perform smart contract security audits, generation, compilation, and token intelligence across eight different blockchains.
Also known as Pentagonal-ai/pentagonal
- Stars
- 1
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Jul 27, 2026
- License
- MIT
What is Pentagonal MCP?
Pentagonal enables AI clients to perform smart contract security audits, generation, compilation, and token intelligence across eight different blockchains. It exposes 7 tools, such as pentagonal_lookup, pentagonal_audit, pentagonal_generate.
Summary generated from the project's README
About Pentagonal MCP server
Pentagonal-mcp provides developers with a suite of tools for smart contract development and security across eight different blockchains, including Ethereum, Solana, Base, and Polygon. It allows AI clients to perform deep security pen tests using an eight-agent system, generate Solidity or Anchor/Rust contracts from natural language, and compile code into ABI and bytecode with gas estimates. Users can also access token intelligence data such as price, holder counts, and honeypot checks.
This server can be integrated into Claude Desktop via stdio or used with Claude Code, Cursor, and Windsurf through an HTTP connection. Setting up the server requires a PENTAGONAL_KEY obtained from the Pentagonal website. While tools like pentagonal_fix, pentagonal_compile, and pentagonal_lookup are free with rate limits, premium features like pentagonal_audit and pentagonal_generate require credits or x402 payments. This setup enables a complete workflow for creating, testing, and verifying blockchain code within an AI-driven environment.
What you can do with it
- 1Perform security auditsRequest a comprehensive security pen test on a smart contract to identify vulnerabilities and proof of concept exploits.
- 2Generate new smart contractsAsk the AI to write a new contract in Solidity or Anchor/Rust based on a written description.
- 3Analyze token dataCheck the liquidity lock status, holder distribution, and potential honeypot risks for a specific token.
- 4Fix contract vulnerabilitiesProvide a specific security flaw and ask the agent to repair it without changing the original contract logic.
Written from the project's README. Every use case is checked against a quote from it.
How to install Pentagonal MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Pentagonal MCP in Claude Code
$ claude mcp add --env 'PENTAGONAL_API_KEY=<YOUR_PENTAGONAL_API_KEY>' pentagonal-mcp -- npx -y pentagonal-mcpInstall Pentagonal MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pentagonal-mcp": {
"command": "npx",
"args": [
"-y",
"pentagonal-mcp"
],
"env": {
"PENTAGONAL_API_KEY": "<YOUR_PENTAGONAL_API_KEY>"
}
}
}
}Install Pentagonal MCP in VS Code
.vscode/mcp.json
{
"servers": {
"pentagonal-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pentagonal-mcp"
],
"env": {
"PENTAGONAL_API_KEY": "<YOUR_PENTAGONAL_API_KEY>"
}
}
}
}Install Pentagonal MCP in VS Code CLI
$ code --add-mcp '{"name":"pentagonal-mcp","type":"stdio","command":"npx","args":["-y","pentagonal-mcp"],"env":{"PENTAGONAL_API_KEY":"<YOUR_PENTAGONAL_API_KEY>"}}'Install Pentagonal MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"pentagonal-mcp": {
"command": "npx",
"args": [
"-y",
"pentagonal-mcp"
],
"env": {
"PENTAGONAL_API_KEY": "<YOUR_PENTAGONAL_API_KEY>"
}
}
}
}Install Pentagonal MCP in Codex
$ codex mcp add pentagonal-mcp --env 'PENTAGONAL_API_KEY=<YOUR_PENTAGONAL_API_KEY>' -- npx -y pentagonal-mcpInstall Pentagonal MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.pentagonal-mcp] command = "npx" args = ["-y", "pentagonal-mcp"] [mcp_servers.pentagonal-mcp.env] PENTAGONAL_API_KEY = "<YOUR_PENTAGONAL_API_KEY>"
Install Pentagonal MCP in Gemini CLI
$ gemini mcp add -s user -e 'PENTAGONAL_API_KEY=<YOUR_PENTAGONAL_API_KEY>' pentagonal-mcp npx -- -y pentagonal-mcpInstall Pentagonal MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pentagonal-mcp": {
"command": "npx",
"args": [
"-y",
"pentagonal-mcp"
],
"env": {
"PENTAGONAL_API_KEY": "<YOUR_PENTAGONAL_API_KEY>"
}
}
}
}Pentagonal MCP tools 7
Detected from the READMEpentagonal_lookuppentagonal_auditpentagonal_generatepentagonal_fixpentagonal_compilepentagonal_rulespentagonal_chains
| pentagonal_lookup | — | |
| pentagonal_audit | — | |
| pentagonal_generate | — | |
| pentagonal_fix | — | |
| pentagonal_compile | — | |
| pentagonal_rules | — | |
| pentagonal_chains | — |
Configuration
PENTAGONAL_API_KEYSecretPentagonal API key (optional — free tools work without it, paid tools accept x402 USDC on Base)
PENTAGONAL_KEY
| Name | Description | |
|---|---|---|
| PENTAGONAL_API_KEY | Pentagonal API key (optional — free tools work without it, paid tools accept x402 USDC on Base) | Secret |
| PENTAGONAL_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablepentagonal-ai/pentagonal is public and reachablegithub.com/pentagonal-ai/pentagonal ↗Pass
- Package names this repository as its sourcepentagonal-mcp names pentagonal-ai/pentagonal as sourcenpmjs.com/package/pentagonal-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-07-27github.com/pentagonal-ai/pentagonal ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from pentagonal-mcpPass
- No critical advisory in the package or its dependencies137 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubpentagonal-mcp
MCP server for Pentagonal — the AI-powered smart contract forge.
Tools
| Tool | Description | Auth |
|---|---|---|
pentagonal_lookup |
Token intelligence — price, holders, LP lock, honeypot, source code | Free (rate limited) |
pentagonal_audit |
8-agent security pen test with severity grouping and PoC exploits | $5 (credit or x402) |
pentagonal_generate |
Generate contracts from natural language (Solidity + Anchor/Rust) | $5 (credit or x402) |
pentagonal_fix |
Fix a specific vulnerability while preserving functionality | Free (rate limited) |
pentagonal_compile |
Compile Solidity to ABI + bytecode + gas estimates | Free (rate limited) |
pentagonal_rules |
View accumulated self-learning security rules | Free |
pentagonal_chains |
List all supported blockchains | Free |
Supports Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, and Solana.
Setup
Claude Desktop (stdio)
Add to claude_desktop_config.json:
{
"mcpServers": {
"pentagonal": {
"command": "npx",
"args": ["-y", "pentagonal-mcp"],
"env": {
"PENTAGONAL_KEY": "your-api-key"
}
}
}
}
Claude Code / Cursor / Windsurf (HTTP)
Add to your MCP config:
{
"mcpServers": {
"pentagonal": {
"type": "http",
"url": "https://www.pentagonal.ai/api/mcp",
"headers": {
"x-pentagonal-api-key": "your-api-key"
}
}
}
}
Get an API Key
- Sign in at pentagonal.ai
- Click your avatar → 🔑 API Keys
- Generate a key — it's shown once, copy it immediately
Payment Options
- Credits — $5 per audit or generate, buy via the web app (EVM or Solana)
- x402 — agents pay per-use with USDC on Base (no account needed)
- API key — use your credit balance programmatically
- Free tools — fix, compile, lookup, rules, chains are free for everyone
Links
- 🌐 pentagonal.ai
- 📦 GitHub
- 🐦 @Pentagonalai
License
MIT
Pentagonal MCP questions
How do I add Pentagonal MCP to Claude Code?
Run claude mcp add --env 'PENTAGONAL_API_KEY=<YOUR_PENTAGONAL_API_KEY>' pentagonal-mcp -- npx -y pentagonal-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Pentagonal MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Pentagonal MCP provide?
It exposes 7 tools, including pentagonal_lookup, pentagonal_audit, pentagonal_generate, pentagonal_fix, pentagonal_compile.
Which blockchains are supported?
The server supports Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, and Solana.
What tools are available for free?
You can use the fix, compile, lookup, rules, and chains tools for free, though they are rate limited.
How much does a security audit cost?
A security audit costs $5, which can be paid using credits or x402.
How do I get an API key?
Sign in to pentagonal.ai, click your avatar, and select API Keys to generate one.