@arqueosfera/mcp
v0.1.1
Published
Arqueosfera MCP server for AI agents (projects, tasks, logbook, results, agent artifacts)
Maintainers
Readme
@arqueosfera/mcp
MCP server for Arqueosfera — projects, tasks, logbook, participant results, WBS templates, and agent artifacts catalog.
Requirements
- Node.js 20+
- An Arqueosfera Integration API key (Settings → Developer)
Environment
| Variable | Description |
|----------|-------------|
| ARCHSPHERE_API_KEY | Workspace-scoped API key (as_live_…) |
| ARCHSPHERE_BASE_URL | https://arqueosfera.com (production) or your local app URL |
Optional:
| Variable | Description |
|----------|-------------|
| ARCHSPHERE_REPO_BUNDLE_PATH | Override path to bundledAgentArtifacts.json for refreshFromRepoBundle |
Smoke test (after publish)
The MCP server speaks stdio — it will look idle in the terminal (no HTTP port). A successful start means the process stays running until you press Ctrl+C.
ARCHSPHERE_API_KEY="as_live_…" \
ARCHSPHERE_BASE_URL="https://arqueosfera.com" \
npx -y @arqueosfera/mcp@latestIf you see Missing Archsphere API key, env vars were not passed. If you see Permission denied / not found for archsphere-mcp, upgrade to 0.1.1+ (fixes executable bin when npx resolves the monorepo copy).
Cursor MCP config
{
"mcpServers": {
"archsphere": {
"command": "npx",
"args": ["-y", "@arqueosfera/mcp"],
"env": {
"ARCHSPHERE_API_KEY": "as_live_…",
"ARCHSPHERE_BASE_URL": "https://arqueosfera.com"
}
}
}
}After changing the package version, reload MCP in Cursor (Settings → MCP).
Development (monorepo)
cd archsphere-mcp
npm install
npm run build
npm testRun locally without publishing:
{
"command": "node",
"args": ["/absolute/path/to/archsphere/archsphere-mcp/dist/index.js"]
}Publish
From archsphere-mcp/ (requires npm org @arqueosfera access and 2FA):
npm login
npm publish --access publicprepublishOnly runs build, tests, and copies the agent artifacts bundle into data/.
Agent artifacts refresh
MCP tool import_agent_artifacts supports:
useBundled: true— server-side delivery bundle (after app deploy)refreshFromRepoBundle: true— bundled catalog shipped in this package (data/bundledAgentArtifacts.json)
License
MIT — see LICENSE.
