FAQ

Does PILSO ever access or store my private keys?

No. PILSO is 100% non-custodial. Your wallet (e.g. MetaMask) signs all transactions manually. Neither the agent, the MCP tools, nor the CLI ever touch your private keys.

---

Which LLMs can I use with PILSO?

You can plug in:

• Claude (via Anthropic API)

• GPT-4 / GPT-3.5 (via OpenAI API)

• Deepseek (via DeepSeek API)

• Local models (coming soon via custom connectors)

You define the LLM in your pilso.config.json.

---

What exactly is an MCP server?

An MCP server is a tool that lets an agent perform one type of task — like compiling a contract or signing a transaction.

They run as local or remote microservices, and return data (not signatures). Each server exposes one or more tools that agents can safely call.

---

What is a "role" in PILSO?

A role defines an agent’s personality, permissions, and behavior. Roles include:

• A description of what the agent is supposed to do

• A list of allowed MCP tools

• Guardrails for safe behavior

• Associated LLM model configuration

Each session in PILSO uses one role at a time.

---

Do I need to run all the MCP servers myself?

You can:

• Run the official MCP servers locally (recommended for devs)

• Host your own in production

• Use third-party hosted MCP endpoints (coming)

This gives you full control over which tools are available to your agents.

---

Which chains does PILSO support?

Any EVM-compatible chain, including:

• Ethereum

• Arbitrum

• Optimism

• Polygon

• Base

• Avalanche

• and more…

More chains can be added by extending chainlist-mcp or adding custom tool endpoints.

---

Can I build my own MCP server?

Yes. You can write your own MCP server in Node, Python, Go, or any backend language. Just expose a standard HTTP POST endpoint with tool metadata and payload handling.

See the [Developer Guide → Build Custom MCP Tools] page (coming soon) for instructions.

---

How do I test a tool without launching an agent session?

Use the direct call interface:

npx pilso call \
  --tool erc20.balanceOf \
  --args '{"wallet": "0x123...", "token": "USDC"}'

This lets you test tools before building agent flows.

---

Is PILSO open source?

Yes. The CLI, core config layer, and official MCP servers are fully open source under the MIT license.